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c.  Select  DECtape-to-Disk  Program  Loading  Options 

Place  the  following  PDP-9  DISK  CONTROL  UNIT  panel  switches  in  the 
"OFF”  (down)  or  ”ON"  (up)  positions  at  the  completion  of  the  DSKSAV  loading  opera¬ 
tion.  The  operator  will  be  signalled  at  the  completion  of  this  operation  by  the  following 
system  ger crated  administrative  message. 

'DSKSAV" 

Disk  control  panel  settings: 

•  Control  switches  0-29  -  "OFF" 

•  WRITE  PROTECT  switch  -  "OFF" 

d.  Transfer  PDP-9  Operating  System  Object  Programs  from  DECtape-to- 
Memory-to-Disk  File  Storage . 

(1)  System  maintenance  program,  DSKSAV  loads  object  coded  ex¬ 
ecutive  system  programs  from  DECtape  to  active  core  memory.  The  resulting  core 
image  program  is  then  transferred  onto  disk.  To  initiate  the  execution  of  this  function, 
perform  the  following  sequence  of  console  operations: 

•  Set  console  ACCUMULATOR  switches  to  000000 

o 

•  Depress  CONTINUE 

(2)  Upon  the  successful  completion  of  system  program  transfer  from 
DECtape  0  tt  disk  storage,  the  following  a  Iministrative  message  is  typed  on-line  via 
the  console  keyboard/page  printer: 

"DSKSAV" 

e.  Reset  Disk  Control  Panel  Options  to  Initiate  the  Loading  and  Building  of 
an  FISS  Disk  Resident  Program  File 

(1)  Place  the  following  PDP-9  Disk  Control  Unit  panel  switches  in  the 
"OFF"  (down)  or  "ON"  (up)  positions: 

•  Control  switches  0-29  -  "ON" 

'  WRITE  PROTECT  switch  -  "ON" 
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£.  Transfer  FISS  Object  Program  from  DECtape-to-Memor/-to-Disk  File 
Storage 

(1)  Initiate  transfer  of  FISS  Object  Program  from  DECtape  2  to  disk 
file  storage  as  follows: 


•  Set  console  ACCUMULATOR  switches  to  000002 

o 

•  Depress  CONTINUE 

(2)  The  following  message  will  be  typed  on-line  when  the  program  load 
and  transfer  operation  previously  described  has  been  completed* 

"DSKSAV" 

3.  DISK-TO-CORE  PD  P-9  MONITOR  LOADING  INSTRUCTIONS 

a.  Load  the  Disk  File  Resident  MONITOR  System  Into  Active  Core  Memory 

(1)  Place  system  utility  program,  DISK,  in  console  paper  tape  reader 

(2)  Set  console  ADDRESS  switches  to  77637 

o 

(3)  Depress  the  following  console  function  keys  in  the  order  specified 

below: 

•  STOP 

•  I/O  RESET 

•  READIN 

(4)  Upon  the  successful  completion  of  the  above  program  loading  fun¬ 
ction,  the  following  system  generated  administrative  message  is  typed  on-line: 

"MONITOR  V4E" 

(5)  The  abovo  message  signals  the  termination  of  the  operating  and  ap¬ 
plications  program  system  disk  loading  sequence,  and  indicates  that  the  core  resident 
MONITOR  program  is  available  for  use .. 
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SECTION  n 


FEATURE  IDENTIFICATION  SOFTWARE  SYSTEM  PROGRAM 

1.  GENERAL 

The  following  paragraphs  describe  the  sequence  of  instructions  to  load  the 
FISS  program  into  core  memory  from  the  PDP-9  disk  program  catalog,  and  to  initial¬ 
ize  the  program  once  control  is  relinquished  by  the  resident  MONITOR.  Both  the  pro¬ 
gram  loading  and  initialization  processes  are  carried  out  on-line  by  way  of  the  PDP-9 
console  teleprinter  and  keyboard  device.  To  accomplish  the  loading  process  the  user 
interacts  with  the  resident  PDP-9  MONITOR  system  as  detailed  in  SectionII2of  this 
appendix.  Program  initialization  is  accomplished  by  interacting  with  the  connection 
control  program,  CNTRL,  and  is  described  in  Section  II.3. 

Tne  following  I/O  message  notation  convention  is  employed  in  this  appendix: 
MONITOR  system  and  FISS  program  generated  output  messages  are  underscored,  as 
shown  in  the  example  below  .  Keyed  input  messages,  entered  by  the  user,  are  not 
underscored. 

Example: 

System  Output  Message:  MONITOR  V4E 

Operator  Input  Message:  LOAD 

2.  FISS  PROGRAM  LOADING  INSTRUCTIONS 

a.  MONITOR  V4E 

System  generated  message  to  signal  the  user  that  the  MONITOR  system 
is  core  memory  resident  and  is  available  for  use. 

b.  G  2 

Enter  the  above  input  message  to  initiate  the  loading  of  the  Feature 
Identification  Software  System  Pi’ogram  from  Disk  Area  2  to  primary  memory. 

c.  t  S 

Enter  this  message  to  start  execution  of  program . 


Preceding  page  blank 
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3. 


PROGRAM  INITIALIZATION  AND  CONTROL  INSTRUCTIONS 


This  section  provides  a  detailed  description  of  the  procedural  steps  needed  to 
initialize  the  Feature  Identification  Software  System .  The  program  initialization  pro¬ 
cess  is  implemented  by  means  of  a  query-response  control  mechanism.  The  on-line 
teletype  serves  as  the  primary  communicatiohs  link  between  man  and  machine,  and  is 
employed  to  generate  administrative  messages  instructing  the  user  of  the  specific  data 
and  control  parameters  needed  for  normal  execution;  to  generate  diagnostic  messages 
signaling  the  type  of  keying  or  procedural  errors  committed  by  the  user  during  the 
initialization  process;  and  to  serve  as  the  input  medium  for  user  response  messages. 

All  user  input  messages  must  be  terminated  by  a  carriage  return,  unless 
otherwise  indicated. 

a.  MOUNT  ACSD  MANUSCRIPT  TAPE  ON  DRIVE  3.  t  P 

b.  t  P 

Enter  CONTROL  Pipon completion  of  above  task. 

c.  MOUNT  ACSD  OVERLAY  TAPE  ON  DRIVE  5.  t  P 

d.  t  P 

Enter  CONTROL  P  upon  completion  of  above  task. 

e.  MOUNT  SCRATCH  TAPE  ON  DRIVE  6.  t  P 

f.  t  P 

Enter  CONTROL  P  upon  completion  of  above  task. 

g.  ENTER  RESOLUTION  AS  2,4,  5  or  6. 

h.  N  t  P 

Enter  ACSD  resolution  increment  value  N  {decimal  integer  *  2,  4,  5  or 
6)  at  which  input  data  was  generated. 

NOTE:  Upward  or  downward  sc  filing  of  the  output  data  file  will  occur 
if  a  resolution  increment  other  than  the  original  ACSD  machine  setting  is  entered. 

i.  ENTER  MIN  AREA  SETTING  AS  XX  ELEMENTS. 

j.  Enter  any  odd  2-digit  number  between  01  and  31  to  indicate  original 
ACSD  MIN  AREA  machine  setting,  e.  g.  03  t  P. 
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k.  ENTER  LINEAL  NEIGHBORHOOD  RANGE  AS  XX  UNITS. 

l.  Enter  a  two-digit  number  greater  than  zero  (e.  g.  05  t  P)  to  indicate 
the  lxxximum  number  r  E  resolution  elements  to  be  used  to  relate  lineal  data  points 
along  the  scan  axis.  Parameter  is  net  requested  if  a  MIN  AREA  of  1  was  indicated. 

m .  ENTER  AREAL  NEIGHBORHOOD  RANGE  AS  XX  UNITS. 

n.  Enter  a  two-digit  number  greater  than  zero  (e.  g.  02  t  P)  to  indicate 
the  maximum  number  of  resolution  elements  to  be  used  to  relate  areal  data  points 
along  the  scan  axis. 

o.  ENTER  MINIMAL  FEATURE  LENGTH  AS  XX  RASTER  UNITS. 

p.  Enter  a  two-digit  number  (XX)  between  01  and  31  to  indicate  the  minim¬ 
um  number  of  raster  data  points  in  a  feature  data  set  for  that  data  set  to  be  retained, 
e.  g.  15  t  P. 


q.  ENTER  GAP  PARAMETER  AS  X  RASTER  UNITS. 

r.  Enter  a  one-digit  octal  number  greater  than  or  equal  to  zero  (e.  g.  1  tP) 
to  indicate  the  maximum  number  of  raster  scan  lines  to  span  to  establish  neighborhood 
connection. 


s.  ENTER  BASE  COLOR  CODE  AS  XX. 

t.  F  iter  a  two-digit  decimal  number  between  00  and  15  to  indicate  the  color 
code  of  the  desirable  base  manuscript  feature.  The  color  codes  are  the  ACSD  machine 
settings  used  for  that  specific  base  manuscript  and  its  associated  overlay. 

4.  ERROR  CONDITIONS  AND  PROGRAM  STOPS 

If  an  abnormal  condition  occurs  during  the  execution  of  the  program,  one  of 
the  following  messages  will  be  printed  on-line  via  the  console  teleprinter. 

a.  STOP  000001 

ACSD  Tape  Error  -  Magnetic  tape  error  encountered  during  ACSD  base 
manuscript  tape  generation. 

b.  STOP  000002 

PDP9GE  Overflow  -  Data  point  encountered  that  exceeds  the  limits  of 

COP  system.  Rerun  program .  If  error  persists,  dump  disk  and  examine  data  set 
point  values  for  possible  error. 
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c.  STOP  000003 

ACSD  Tape  Error  -  Magnetic  tape  error  encountered  during  ACSD  over¬ 
lay  tape  generation. 

d.  STOP  000004 

Line  Buffer  Overflow-ACSD  scan  line  record  encountered  on  base  man¬ 
uscript  tape  that  is  larger  than  the  fixed  sized  raster  record  irput  buffei . 

e.  STOP  000005 

Core  Memory  Overflow  -  More  than  128  feature  data  sets  simultaneously 
active  in  memory.  Reload  program  and  increase  the  range  parameters  in  input  mess¬ 
ages  (k)  and  (ro) . 

f.  STOP  000006 

Disk  Overflow  -  Availab'e  disk  storage  exhausted.  Reload  connection 
program  increase  or  decrease  neighborhood  range  parameters  (see  input  messages  k 
and  m). 

g.  STOP  000007 

Line  Buffer  Overflow  -  ACSD  scan  line  record  encountered  on  overlay 
tape  that  is  larger  than  the  fixed  sized  raster  record  input  buffer. 

5.  PROCESSING  STATISTICAL  DATA  OUTPUTS 

Immediately  following  the  successful  completion  of  the  lire  connection  process, 
timing  and  data  statistics  are  printer  on-line  via  the  console  teleprinter  .  These  in¬ 
clude  the  numher  of  points  input  and  output,  convergences  and  divergences  of  features, 
linear/axual  L  asitions  encountered,  feature  data  sets  output,  and  so  on.  Figure  1-1 
contains  a  typical  example  of  the  statistical  data  generated. 
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MONITOR  V4E 

SG  2 

*S 

MOUNT  ACSD  MANUSCRIPT  TAPE  ON  DRIVE  3.»P 
tP 

MOUNT  ACSD  OVERLAY  TAPE  ON  DRIVE  5.*P 
»P 

MOUNT  SCRATCH  TAPE  ON  DRIVE  6.»P 
*P 

ENTER  RESOLUTION  AS  2>^*5>0R  6*  > 

4»P 

ENTER  MIN  AREA  SETTING  AS  XX  ELEMENTS •  * 

01tp 

ENTER  AREAL  NEIGHBORHOOD  RANGE  AS  XX  UNITS.  > 

01  *P 

ENTER  MINIMAL  FEATURE  LENGTH  AS  XX  RASTER  UNITS.  > 
10»P 

ENTER  GAP  PARAMETER  AS  X  RASTER  UNITS.  > 

1»P 

ENTER  BASE  COLOR  CODE  AS  XX.  > 

09tP 


RASTER-TO -LOCUS  CONVERSION  STATISTICS 


NUMBER  OF  POINTS  INPUT  =  2835. 

NUMBER  OF  POINTS  OUTPUT  <=  2787. 

NUMBER  OF  CONVERGES  »  30 

NUMBER  OF  DIVERGES'  «  31 


NUMBER  OF  LINEAR/ AREAL  TRANSITIONS  «  17 

NUMBER  OF  FEATURE  DATA  SETS  =  137 

NUMBER  OF  FEATURES  UNDER  MINIMAL  LENGTH  -  51 

NUMBER  OF  DISK  SEGMENTS  UEED  =  288 

APPROXIMATE  LENGTH  OF  PRODUCT  =  11.148 

RUN  TIME  -  1  MIN.  2  SEC. 


MONITOR  V4F 
S 


FIGURE  1-1  .  FISS  PROGRAM  RUN 
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SECTION  H  (CONT) 


SECTION  I 


1.  GENERAL 

The  system  software  elements  described  in  this  appendix  consists  of  the  new 
subprograms  required  and  the  CAST  Engineering  Change  "A"  programs  modified  to 
implement  the  Feature  Identification  Software  System  (FISS).  The  four  new  programs 
are  detailed  in  Section  IL.Gf  the  programs  resulting  from  the  CAST  Engineering  Change 
"A"  effort,  FILBUF  required  extensive  changes  and  is  detailed  in  Section  ELI,  while 
four  other  programs  required  only  minor  modifications  which  are  described  in  Section 
H.2.  All  other  CAST  programs  remain  as  originally  documented.  Section  II. 3 
identifies  the  PDP-9  Object- Time  System  programs  and  Science  Library  macro  sub¬ 
routines  required  for  various  Fortran  IV  I/O  and  mathematical  functions.  Section  HI 
contains  the  flow  diagrams  of  the  FISS  programs  described  in  Section  II.  1  and  II. 2. 


2.  SYSTEM  DESCRIPTION 

The  FISS  Program  is  a  self-contained,  stand-alone  program  designed  to  be  ex¬ 
ecuted  on  a  PDP-9  processing  system  having  the  following  configuration: 

Quantity  Equipment  Item  Description 


1  DEC  PDP-9  Control  Processing  Unit  (CPU) 

8  4096  18-bit  Word  Core  Memory  Modules 

1  10  CPS,  Console  Keyboard/Teleprinter 

3  7-Track,  45IPS,  556/800  BPI  IBM  Compatible  Magnetic  Tape 
Units  W/Controller 

4  DECtape  Units  W/Controller 

1  DEC  PDP-9  Paper  Tape  Reader 

1  DEC  PDP-9  Paper  Tape  Punch 

1  1  Million  18 -Bit  Word  Dijsk  File  W/Controller 

1  ANELEX,  1000  LPM  Line  Printer 


a.  Object  Program  Deck  Arrangement 


The  FISS  Program  is  assembled  and  compiled  as  a  "relocatable"  program. 
With  the  exception  of  the  control  program  (CNTRL),  which  by  definition  must  be  the 
first  program  in  the  object  deck,  the  remaining  object  programs  may  be  arranged  in 
any  order. 


b.  System  Diagrams 


Figure  H-l  shows  the  control  logic  flow  for  the  FISS  program.  PDP-9  OTS 
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and  Science  Library  subprograms  and  routines  are  not  shown  since  they  are  loaded 
and  enter  the  procedureal  flow  only  at  the  time  of  execution.  As  s.iown,  the  program 
as  designed  is  divided  into  three  functional  phases  of  execution:  Initialization  and 
Phase  I  and  J3 . 

(1)  Initialization 

Package  consists  of  the  worker  programs  shown  in  addition  to  PDP-9 
OIS  input/output  handlers  and  drivers  loaded  at  time  of  execution  .  These  provide  a 
software  controlled  user-system  interface  as  is  required  either  to  enter  needed  control 
information  and  data,  or  to  output  system  generated,  administrative  messages  via  the 
console  keyboard/teleprinter  devices. 

(2)  Phase  I 

Software  is  devoted  to  the  enactment  of  the  point-to-point  correl¬ 
ation  functions  as  performed  by  the  software  modules  indicated.  Such  functions  are 
performed  in  a  serial  batch  mode  of  operation.  Overlay  color  information  is  correl¬ 
ated  to  base  manuscript  positional  data  to  establish  symbolic  color-coded  feature 
header  information.  Lineal  formatted  output  data  records  are  retained  in  disk  file 
storage  until  a  base  color  data  connection  pass  is  completed .  Such  data  is  then  made 
available  to  the  Phase  II  processor  for  final  output  formatting. 

(3)  Phase  II 

Consists  of  those  translatory  and  record  dala  formatting  functions 
as  required  to  transform  internally  formatted  data  records  to  the  required  standard 
ACS  Manuscript  (MMS)  Tape  File  Format.  This  processor,  like  the  previous  Phase  I 
processor,  is  designed  to  enact  these  functions  in  a  serial  batch  processing  mode. 

Figure  II-2  shows  the  overall  functional  block  diagram  of  the  FISS 

program . 

c.  Logic  Diagram  Symbology 

The  syllabus  of  logic  diagram  symbology,  as  shown  in  Figure  II-3,  defines 
the  program  flow  diagram  notation  conventions  employed  in  this  appendix. 
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FIGURE  II  -  2.  FEATURE  IDENTIFICATION  SOFTWARE  SYSTEM  BLOCK  DIAGRAM 
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FIGURE  U-3.  LOGIC  DIAGRAM  SYMBOLOGY 


SECTION  n 


? 


DESCRIPTION  OF  SUBPROGRAMS 


1.  NEW  FISS  PROGRAMS 

a.  UPDATE  (Update  Mother  Data  Set) 

(1)  Abstract 

UPDATE  updates  the  mother  data  set  block  identifying  a  feature  with 
data  set  linkage  and  color  identification  information. 

(2)  Program  Description 

Upon  unconditional  data  set  termination  UPDATE  retrieves  the 
specified  mother  data  set  block  from  disk,  if  not  already  core-resident,  updates  cor¬ 
relation  pointer  no.  2  with  data  set  linkage  information,  overwrites  a  data  set  header 
no  longer  used  with  the  core-resident  color  identification  word  describing  the  data  set, 
and  rewrites  the  mother  dat<.  set  block  to  disk.  In  the  case  of  core  resident  mother 
data  set  blocks,  the  initial  disk  read  is  bypassed.  The  update  information  is  used 
by  COLCLR  for  feature  header  formulation. 

(3)  Inputs 

Calling  Sequence  - 


L 

L  *  1 

L  +  2 

where:' 


LAC 

JMS* 


DSC  AD 
UPDATE 

Next  sequen¬ 
tial  instruction 


DSC  AD  -  core  address  of  data  set  block. 


(4)  Outputs 
Disk  - 

Updated  mother  data  set  block. 

(5)  Referenced  Subprograms 
DSKRW 


Preceding  page  blank 
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b.  DCDCOL  (Decode  Color) 

(1)  Abstract 

DCDCOL  updates  the  specified  core-resident  data  set  block  color 
word  with  color  identification  information. 


(2)  Program  Description 


DCDCOL  uses  the  contents  of  the  ACC  (color  code)  to  compute  a 
table  address  of  the  corresponding  bit  map  representation  for  that  color  code .  The 
data  set  requiring  a  color  identification  update  is  identified  via  the  data  set  address 
passed  in  the  calling  sequence.  For  each  call  to  DCDCOL  the  current  color  word  for 
the  specified  data  set  is  logically  ORed  with  the  bit  map  representation  of  the  color 
code  identified  in  the  calling  sequence . 

(3)  Inputs 


Calling  Sequence  - 


L 

LAC 

L  +  1 

JMS* 

L  a  2 

SKP 

L  +  3 

ARG 

0 

L  +  4 

where:. 

COLOR 

DCDCOL 

Return  location 

Next  sequential 
instruction 


ARG  =  core  address  of  data  set  block. 


(4)  Outputs 


Memory  - 


Updated  data  set  color  word. 


(.5)  Referenced  Subprograms 


None 


c .  COLCLR  (Collect  Color) 

(1)  Abstract 

COLCLR  is  the  Raster  Plotter  Color  Code  Implementation  routine 
that  collects  all  the  color  codes  from  all  the  data  sets  associated  with  a  feature  in 
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order  to  formulate  the  proper  header  for  that  feature. 


(2)  Program  Description 


COLCLR  is  called  by  TRMDS  whenever  the  correlation  between  the 
data  sets  of  a  feature  and  the  overlay  color  codes  has  been  completed.  COLCLR 
cnains  through  all  the  data  sets  associated  with  a  given  feature,  extracting  the  required 
color  code  from  each  data  set  as  it  goes  along. The  data  sets  are  read  from  disk  using 
DSKRW ,  Required  information  from  the  data  block  headers  is  extracted  by  the  intern¬ 
al  routine  HEADER.  Another  internal  routine,  GETHDR,  takes  the  extracted  color 
code  information,  separates  out  the  proper  color  code  and  formulates  the  appropriate 
word  for  the  feature  header  identification. 


(3)  Inputs 

Calling  Sequence  - 

JMS*  COLCLR 

JMP  .+3 

.DSA  ARG1 

0 

Next  sequential  in¬ 
struction 

where:; 

ARG1  =  mother  block  of  an  end  of  the  feature  for  which 
the  color  information  is  to  be  collected. 

ARG2  -  the  header  word  returned  to  the  calling  program. 

(4)  Outputs 
Memory  - 

Color  code  word  that  uniquely  identifies  the  type  of  feature  interested 
in. 

(5)  Referenced  Subprograms 
D-KRW 


L 

L  +  1 
L  +  2 

L  +  3  ARG2 
L  +  4 


d.  FILBUF  (Fill  Line  Buffer) 

(1)  Abstract 

FILBUF  buffers  raw  ACSD  records  from  magnetic  tape  to  an  internal 
buffer  and  transfers  logical  scan  line  records  and  its  associated  color  information  from 
the  tape  buffer  to  a  specified  scan  line  memory  buffer  and  its  associated  color  identif- 
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icatkra  buffer.  T'he  raster  scar  value  (y  -  coordinate)  is  returned  to  the  calling  pro¬ 
gram. 


(2)  Program  Description 

FILBUF  is  called  whenever  a  line  buffer  is  to  be  filled.  Each  call 
fills  the  spec  fied  line  buffer  with  coordinate  data  of  the  next  consecutive  scan  line. 

The  coordinate  data  is  followed  by  a  trailer  word  indicating  the  end  of  coordinate  data. 
Associated  with  each  data  element  in  the  line  buffer  is  an  ACSD  color  code  in  the 
associated  color  identification  buffer  identifying  the  color  code  representing  that  partic¬ 
ular  data  element. 


FILBUF  recognizes  three  types  of  raster  elements  appearing  in  the 
raw  ACSD  records.  Line  center  and  areal  data  are  directly  transferred  from  the  tape 
to  the  specified  line  buffer,  Min  Area  data  is  conditionally  transferred  to  the  specified 
line  buffer.  For  a  Min  Areas  of  one,  Min  Area  data  is  interpreted  as  noise  and  is  not 
passed  to  the  line  buffer  as  valid  data.  7  Min  Area  settings  other  than  one,  the  Min 
Area  data  points  are  converted  to  a  beg:  ■.  area  point,  and  an  end  area  point  is  gener¬ 
ated  using  the  begin  area  plus  the  Min  Area  setting  minus  one .  Tf  the  line  buffer  cap¬ 
acity  (1024  words)  is  reached,  line  buffer  overflow  has  occurred,  otherwise  the  y-coord- 
inate  associated  with  the  x-coovdinate  data  is  returned  to  the  calLng  progr  .m.  An  end- 
of-data  condition  is  indicated  to  the  calling  program  by  a  return  to  the  locution  follow¬ 
ing  the  call  arguments  address. 


If  line  buffer  overflow  occurs,  a  terminal  condition  is  reached,  and 
the  program  is  aborted  causing  the  following  message  to  be  output  on  the  teleprinter: 
"STOP  000004"(STOP  000007).  If  a  tape  error  was  encountered  during  ACSD  tape 
generation,  ?n  error  condition  is  recognized  and  the  program  aborted  causing  the 
following  message  to  be  output  on  the  teleprinter:  "STOP  000001"(STOP  ,000003), 

(3)  Inputs 

(a)  Calling  Sequence  - 


L 

JMS* 

L  +  1 

JMP 

L  +  2 

L  +  3 

JMP 

L  +  4 

where: 

FILBUF 

.+3  Return  location 

ARG 

FOD  End-ot-uata 

return  location 
Next  sequential 
instruction 


ARG  =  address  of  buffer  arguments 
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where  buffer  arguments: 

ARG1  =  address  of  line  buffer  address 
ARG2  =  y-coordinate  of  line  in  buffer 

(b)  Magnetic  Tape  - 

Raw  ACSD  multi-color  file  data  records  (1024  24-bit  words) . 

(4)  Outputs 

(a)  Memory  - 

Scan  line  buffers  of  raster  data  elements  and  associated 
color  identification  buffers. 

(b)  Teleprinter  - 

The  following  message  is  output  when  line  buffer  overlow 
(base  manuscript  tape)  occurs:  "STo0"  000004". 

The  following  message  is  output  when  line  buffer  overflow 
(overlay  tape)  occurs  'STOP  000007". 

The  following  message  is  output  when  ACSD  tape  error 
(base  manuscript  .ape)  is  encountered:  "STOP  000001", 

The  following  message  is  output  when  an  ACSD  tape  error 
(overlay  tape)  is  encountered:  "STOP  000003". 

(5)  Referenced  Subprograms 

None 


2.  MODIFIED  CAST  PROGRAMS 

a.  CNTRL  (Feature  Identification  Software  System  Control  Program) 

(1)  Abstract 

CNTRL  is  the  supervisory  program  element  of  the  Feature  Identif¬ 
ication  Software  System.  Following  system  initialisation  the  program  buffers  raster 
scan  records  from  raw  ACSD  tap.?  files  by  calling  FIi^BUF,  locates  and  extracts  data 
elements  and  associated  color  code  information  from  line  buffers  by  calling  EXTRCT, 
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and  correlates  the  data  elements  to  active  feature  data  sets  by  calling  the  line  connect¬ 
ion  algorithm .  Feature  data  set  initialization  and  construction  are  performed  by 
STRDS  and  ENTDS  respectively.  MMS  tape  generation  is  initiated  by  TRMDS  upon 
successful  completion  of  the  feature  data  set  generation.  Statistical  information  com¬ 
piled  during  program  execution  is  output  via  the  teleprinter  and  control  is  returned  to 
the  system  MONITOR. 

(2)  Program  Description 

During  system  initialization  CNTRL  receives  via  the  on-line  teletype 
the  specific  input  parameters  wh  ch  are  to  be  used  to  process  the  selected  ACSD 
tapes.  Feature  line  segments  are  represented  as  data  set  blocks  (mother  block  and  its 
associated  daughter  blocks).  Each  raster  scan  element  (lineal  or  areal)  is  mapped 
into  each  active  data  set  in  search  of  a  neighborhood  correlation.  If  a  raster  element 
meets  the  neighborhood  criteria  of  an  active  data  set,  it  is  entered  into  that  active 
data  set,  otherwise  the  raster  element  is  used  to  create  a  new  data  set.  As  raster 
elements  in  the  scan  line  buffer  are  exhausted,  a  new  scan  line  record  is  introduced. 

As  a  data  set  block  becomes  full,  the  block  is  catalogued  and  transferred  from  active 
memory  to  disk  for  retrieval  upon  final  termination  of  the  line  connection  process. 

As  feature  data  sets  are  created  from  positional  data  represented  on 
the  base  manuscript,  symbolic  colo:  data  represented  on  the  color  overlay  is  correl¬ 
ated  to  the  feature  data  sets.  Color  over1  ay  data  is  compiled  for  each  feature  data  set. 
Upon  unconditional  feature  data  set  termination,  the  color  information  is  included  in 
the  mother  dc  a  set  block  of  the  feature  data  set. 

A  data  set  is  not  immediately  terminated  if  no  raster  element  can 
be  associated  to  that  data  set  for  a  particular  scan  line.  This  data  set  remains  active 
for  N  scan  lines  as  requested  during  system  initialization  by  the  gap  parameter.  If 
N  scan  lines  are  processed  without  a  coordinate  update  of  an  active  data  set,  the  uata 
set  is  unconditionally  terminated. 

Conditional  data  set  termination  occurs  when  a  convergent  data  condi¬ 
tion  is  recognized  by  CNTRL,  i.  e.,  when  multiple  data  sets  are  related  to  a  single 
raster  element.  When  convergence  occurs,  the  converging  data  sets  are  conditionally 
terminated  and  the  object  raster  element  is  used  to  create  a  new  data  set  which  is 
marked  as  a  convergent  data  set  and  is  linked  to  the  above  related  data  sets .  The  con¬ 
vergent  data  set  is  eventually  used  to  define  the  intersection  point  of  the  convergent 
data.  Dependent  upon  the  value  of  the  minimal  feature  length  parameter  entered  via  the 
teletype  during  system  initialization  the  convergent  data  set  completely  defines  the 
intersection  point  (minim  a)  or  is  of  valid  length  to  be  a  distinct  line  segment  feature 
of  its  cwn.  Once  the  intersection  point  is  established,  it  is  entered  as  the  last  point 
of  its  associated  conditionally  terminated  data  sets  which  are  then  unconditionally 
minated.  If  two  data  sets  converge  into  a  single  data  set  which  is  under  minimal 
feature  length,  the  two  data  sets  remain  correlated  to  each  other.  If  either  more  than 
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two  data  sets  converge  into  a  single  data  set  or  the  convergent  data  set  is  of  minimal 
feature  length,  the  convergent  condition  correlations  are  erased. 

Divergent  data  conditions  (maxima),  i.  e. ,  when  multiple  raster  el¬ 
ements  are  related  to  a  single  active  data  set,  also  require  the  resolution  of  an  inter¬ 
section  point.  In  this  case  the  single  active  data  set  is  the  divergent  data  set  and  is 
used  to  resolve  the  intersection  poinv“of  the  divergent  data.  Again,  if  the  data  set  is 
under  minimal  feature  length,  the  data  is  not  a  valid  feature  and  is  used  only  to  resolve 
the  intersection  point  which  is  used  to  create  the  new  data  sets  defined  by  the  divergent 
raster  elements.  If  the  divergent  data  set  is  under  minimal  feature  length  and  only 
two  data  sets  diverge  from  it,  the  two  data  sets  are  correlated  to  each  other.  If  either 
the  divergent  data  set  is  of  minimal  feature  length  or  more  than  two  data  sets  diverge 
from  the  divergent  data  set,  the  divergent  condition  correlations  are  not  created. 

All  data  sets  which  are  unconditionally  terminated,  uncorrelated  to 
any  other  data  sets,  and  are  under  minimal  feature  length  are  considered  to  be  noise 
and  are  not  transferred  to  disk  as  a  valid  line  segment  feature.  All  other  data  sets 
constitute  valid  line  segment  features  and  are  trarsferred  to  disk. 

When  line  connection  is  completed  CNTRL  calls  TRMDS  to  create 
a  lineal  file  tape  in  MMS  format.  Color  information  compiled  during  feature  data 
set  generation  is  used  to  create  the  feature  header  record.  Statist  cal  information 
compiled  during  execution  of  the  line  connection  function  is  output  via  the  teleprinter 
upon  successful  program  completion. 

(3)  Inputs 

(a)  Calling  Sequence  - 

None  -  stand  alone  program 

(b)  Keyboard  Entries  —  Operator  Input  Response 

"tP" 

"XtP" 

"XXtP" 

(c)  Magnetic  Tape  - 

1  raw  ACSD  base  manuscript  file  . 

1  raw  ACSD  color  overlay  file . 
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(4)  Outputs 

(a)  Teleprinter  - 

Program  generated  query  and  administrative  messages: 

"MOUNT  ACSD  MANUSCRIPT  TAPE  ON  DRIVE  3 .  t  P" 

'MOUNT  ACSD  OVERLAY  TAPE  ON  DRIVE  5 .  t  P" 

'MOUNT  SCRATCH  TAPE  ON  DRIVE  6.  tP" 

"ENTER  RESOLUTION  AS  2,  4,  5,  or  6.>  " 

"ENTER  MIN  AREA  SETTING  AS  XX  ELEMENTS.>  " 

"ENTER  LINEAL  NEIGHBORHOOD  RANGE  AS  XX  UNITS.>  " 
"ENTER  AREAL  NEIGHBORHOOD  RANGE  AS  XX  UNITS .>  " 
"ENTER  MINIMAL  FEATURE  LENGTH  AS  XX  RASTER  UNITS.>" 
"ENTER  GAP  PARAMETER  AS  X  RASTER  UNITS. >  " 

"ENTER  BASE  COLOR  CODE  AS  XX. >  " 

Program  generated  statistical  information. 

(b)  Magnetic  Tape  - 

1  lineal  formatted  feature  file  tape . 


(5)  Reference  Subprograms 

CNCT 

FILBUF 

STRDS 

ENTDS 

TRMDS 

EXTRCT 

ALINE 

WMAGTP 

STATS 

DSKRW 

TTYOUT 

TTYIN 

DCDCOL 

UPDATE 
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b.  TRMDS  (Terminate  Data  Set) 
(1)  Abstract 


TRMDS  creates  the  lineal  formatted  MMS  data  file .  Once 
line  connection  is  completed,  the  subprogram  is  called  by  CNTRL  to  transfer  all  the 
line  segment  features  residing  on  disk  to  magnetic  tape  in  MMS  format.  Multiple  line 
segment  features  (mother  data  set  block  and  0  to  N  daughter  data  set  blocks)  may  con¬ 
stitute  an  actual  feature  due  to  the  nature  of  data  set  generation  at  points  of  maximum 
and  minima.  As  each  data  set  block  is  retrieved,  TRMDS  unpacks  the  coordinates, 
scales  the  coordinates  by  calling  SCAL,  converts  the  coordinates  to  MMS  format  and 
combines  any  multiply  segmented  features  into  a  single  line  feature  into  a  single  line 
feature.  TRMDS  calls  COLCLR  to  collect  all  tV,e  color  information  associated  with  a 
single  line  segment  feature.  Following  the  header  information  the  coordinate  data  are 
transferred  to  magnetic  tape  by  calling  WMAGTP.  TRMDS  only  processes  the  data 
existing  between  the  first  and  last  data  set  block  allocated. 

(2)  Program  Description 

TRMDS  uses  DSKADD  and  DSKRW  to  search  the  disk  in 
search  of  mother  blocks.  Once  a  mother  block  and  its  associated  daughter  blocks 
are  located,  their  headers  are  checked  for  any  correlation,  i.  e. ,  another  mother  - 
daughter  linkage  which  defines  a  continuation  of  the  current  line  segment  feature.  If 
a  correlation  exists  the  correlated  line  segment  feature  becomes  the  current  line  seg¬ 
ment  feature  and  the  above  process  is  repeated  until  all  the  line  segment  features  de¬ 
fining  a  single  feature  are  known  and  the  endpoint  of  the  line  feature  is  reached,  or 
in  the  case  of  a  closed  feature,  the  correlation  returns  the  chaining  of  line  segment 
features  to  the  original  data  set.  If  no  correlation  exists  the  subprogram  immediately 
creates  the  MMS  records  describing  the  line  segment  feature. 


All  mother  blocks  used  in  creation  of  a  single  line  feature 
are  marked  as  used  s:  that  they  will  not  again  be  processed  as  the  disk  is  searched 
sequentially.  Since  all  data  set  features  are  built  with  y-coordinates  increasing  in 
value,  TRMDS  processes  every  other  line  segment  feature  defining  a  single  line  in  an 
inverse  direction,  i.  e. ,  at  points  of  maxima  and  mimima  the  function  describing  the 
locus  path  changes  in  direction.  Color  information  compiled  for  each  feature  data  set 
and  collected  by  COLCLR  is  used  to  create  the  fealare  header  record.  All  coordinate 
data  is  unpacked,  scaled,  converted  to  GE  floating  ."ormat  and  written  to  magnetic  tape. 
TRMDS  also  accumulates  statistical  information  which  is  transferred  to  STATS  to  be 
output  via  the  teleprinter. 
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(3) 


Inputs 


Calling  Sequence  - 


L 

JMS* 

TRMDS 

L  +  1 

SKP 

Return  loca¬ 

L  +  2 

ARG 

tion 

L  +  3 

Next  sequen¬ 
tial  instruction 

where: 

ARG  =  address  of  data  set  argument. 


where  data  set  argument. 

ARG1  =  core  address  of  data  set  block. 


(4)  Outputs 
Magnetic  Tape  - 

Lineal  formatted  feature  data  sets  via  subprogram  WMAGTP. 

(5)  Referenced  Subprograms 

DSKRW 

DSKADD 

WMAGTP 

PDP9GE 

SCAL 

COLCLR 

c .  EXTRCT  (Data  Point  Extraction) 

(1)  Abstract 

EXTRCT  extracts  raster  elements  (lineal  and  areal)  from  a  scan 

line  buffer. 

(2)  Program  Description 

EXTRCT  extracts  the  next  raster  element  in  the  specified  line  buffer 
and  returns  the  raster  element  (one  word  if  lineal;  t*vo  words  if  areal)  to  the  calling 
programs.  EXTRCT  also  returns  the  color  code  associated  with  the  line  buffer  entry 
or  entries.  Upon  exit  from  the  subprogram  the  value  of  the  accumulator  indicates 
the  type  of  raster  element  returned.  An  end-of-line- buffer  condition  is  indicated  to 
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the  calling  program  by  a  return  to  the  location  following  the  call  arguments  address. 


(3)  Inputs 

Calling  Sequence  - 


L 

JMS* 

EXTRCT 

L  +  1 

JMP 

.+3 

Return  loca¬ 
tion 

L  +  2 

ARG 

L  +  3 

JMP 

EOD 

End-of-data- 

return 

L  +  4 

Next  sequen¬ 
tial  instruct¬ 
ion 

where: 


AhG  =  address  of  buffer  arguments, 
where  buffer  arguments: 

ARG1  =  current  line  buffer  address. 

ARG2  =  first  data  po.;nt  (line  center  or  begin  area). 
ARG3  =  second  data  point-end  area  (areal  data  only) . 
ARG4  =  entry  or  entries  color  code. 


(4)  Outputs 
Memory  -• 

Raster  elements  and  element  type  (via  ACC)  to  the  calling  program. 

(5)  Referenced  Subprograms 

None 

d.  ALINE  (Intersection  Resolution) 

(1)  Abstract 

ALINE  is  called  to  resolve  the  intersection  point  of  convergent  and 
divergent  data.  The  minimal  feature  length  is  used  to  determine  whether  the  incoming 
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data  set  (divergence)  or  the  outgoing  data  set  (convergence)  is  of  valid  length  to  be  a 
distinct  feature  of  its  own  or  is  used  only  to  resolve  the  intersection. 

(2)  Program  Description 

ALINE  is  called  whenever  a  divergent  or  convergent  data  transition 
occurs.  In  either  case  a  common  intersection  point  must  be  defined.  In  the  convergent 
case  resolution  of  the  intersection  point  is  delayed  for  N  scan  lines  until  the  outgoing 
data  set  is  of  valid  length  or  is  terminated.  When  either  occurs  the  convergent  inter¬ 
section  point  becomes  the  last  data  entry  in  all  incoming  data  sets  wliich  are  then  term¬ 
inated  and  the  first  data  entry  in  the  outgoing  data  set,  otherwise  the  outgoing  data  set 
is  eliminated  from  the  data  base.  For  the  divergent  case  resolution  of  the  intersection 
point  is  immediate  since  the  incoming  data  set  contains  the  required  data  for  resolu¬ 
tion.  If  the  incoming  data  set  is  of  valid  length,  the  divergent  intersection  point  be¬ 
comes  the  first  data  entry  in  all  outgoing  data  sets  and  the  last  data  entry  i:.  the  in¬ 
coming  data  set,  otherwise  the  incoming  data  set  is  eliminated  from  the  data  base. 

The  mother  data  set  block  of  any  data  set  feature  of  legitimate  length  is  updated  with 
color  and  linkage  information  via  UPDATE. 


(3)  Inputs 

Calling  Sequence  - 


L 

JMS* 

L  +  1 

SKP 

L  +  2 

L  +  3 

where: 

ALINE 

Return  location 

ARG 

Next  sequential  instruct 
ion 


ARG  =  address  of  data  .set  arguments. 

where  data  set  arguments: 

ARG1  =  core  address  of  data  set  block. 

NOTE:  Contents  of  ACC  indicate  convergent  or  divergent  data. 

(4)  Outputs 

Memory  - 

Data  set  blocks  with  resolved  intersection  points. 


(5) 


Referenced  Subprograms 


DSKRW 

ENTDS 

UPDATE 

3.  OBJECT-TIME  SYSTEM  AND  SCIENCE  LIBRARY  ROUTINES 

a.  Object-Time  System  Routines 

The  following  is  a  list  of  PDP-9  FORTRAN  IV  Object- Time  System 
macro- subroutines  that  are  loaded  at  execution  time.  The  compiled  FORTRAN  pro¬ 
grams  which  contain  I/O  statements  include  outpit  calls  in  the  form  of  globals  to  various 
system  I/O  handler  routines.  When  the  compiled  object  program  is  loaded,  the  com¬ 
piler  defined  global  symbols  are  utilized  to  search  the  FORTRAN  library  for  the 
needed  I/O  handler  routines.  These  are  loaded  into  memory  and  the  proper  program 
control  linkage  established  by  the  Link  Loader.  Detailed  description  for  these  pro¬ 
grams  are  provided  in  the  following  DEC  PDP-9  manual  "Advanced  Software  System 
Programmer's  Reference  Manual";  order  number  DEC-9A-KFZA-D. 

Program  Name  Function  Ref.  Manual 

FIOPS  FIOPS  provide  the  necessary  call  P.  11-10 

to  10 PS  (input-Output  Processing 
System)  required  by  all  FORTRAN 
I/O  statements. 

OSTER(.ER)  To  announce  an  error  on  the  telaiyoe.  P.  11-18 

TIME  To  provide  the  ability  to  record  e)  P.  11-21 

apsed  time  in  minutes  and  seconr.s. 

BCDIO  To  process  iormatted  READ/WR7TE  P.  11-13 

statements  in  FORTRAN  IV  program 
and  sub-programs. 

,SS  To  calculate  the  array  element  ad-  P.11-12 

dress. 

STOP(.ST)  To  process  the  STOP  statement  P.11-15 

and  return  control  to  the  monitor. 

SPMSG(.SP)  To  print  the  octal  number  coded  P.  11-17 

with  STOP. 
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b.  Science  Library  Routines 

The  following  PI>r-9  Science  I  ibrary  mathematical  routines  are 
utilized  by  the  FLSS  programs.  These  programs  are  described  in  the  DEC  PDP-9 
manual  referenced  in  Section  Q,  Subsection  3  .a  above. 


Routine  Name 

External  Calls 

Ref.  Manual 

ABS 

.DA,  REAL 

P.  III-5 

FLOAT 

.DA,  REAL 

P.  m-5 

SIGN 

.DA,  REAL 

p.  m-5 

.DA(General  Get  Argument) 

None 

P.  Ill- 8 

INTEGE (Integer  Arithmetic) 

REAL 

P.  Ill- 8 

REAL  (Real  Arithmetic) 

None 

p.  m-8 

.CB  (Short  Cet  Argument) 

None 

p.  m-9 
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SECTION  III 
FISS  FLOW  DIAGRAMS 
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M  OF  UPDATE 
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FIGURE  11  -  5.  FLOW  DIAGRAM  CF  DCDCOL 


FIGURE  II  -  6,  FLOW  DIAGRAM  OF  COLCLR 


FIGURE  H  -  7.  FLOW  DIAGRAM  OF  FILBUF  (CONDLUDED) 


FIGURE  n  -  8.  FLOW  DIAGRAM  OF  CNTRL 


FIGURE  II  -  8.  FLOW  DIAGRAM  OF  CN  f  RL  (CONTINUED) 


FLOW  DIAGRAM  OF  CNTRL  (CONTINUED) 


FIGURE  II  -  8  FLOW  DIAGRAM  OF  CNTRL  (CONCLUDED) 
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FIGURE  II  -  9.  FLOW  DIAGRAM  OF  TRMDS  (CONTINUED) 
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FIGURE  11  -  10.  FLOW  DIAGRAM  OF  EXTRCT 


FIGURE  H  -  11.  FLOW  DIAGRAM  OF  ALINE 


FIGURE  H  -  11.  FLOW  DIAGRAM  OF  ALINE  (CONTINUED) 
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SECTION  I 


DISK  PROGRAM  CATALOGING  PROCEDURE 


1.  GENERAL 

The  following  paragraphs  outline  in  detail  the  procedural  steps  needed  to  build  a 
catalog  of  disk-resident  PDP-9  operating  system  and  RPSS  applications  programs. 

Ti  e  RPSS  is  designed  as  a  stand  alone  program  and  consists  of  one  load  module  of 
twenty -one  (21)  subprograms.  These,  in  addition  to  the  PDP-9  Operating  System  and 
Science  Library  reside  on  DECtape  as  object  programs.  In  order  to  build  an 
executable  load  module  of  these  programs  on  disk  storage,  they  must  be  initially  load¬ 
ed  into  core  memory,  and  the  resulting  core  image  transferred  to  disk  file  storage. 
The  following  instructions  describe  this  procedure. 

2.  DECTAPE-TO-DISK  LOADING  INSTRUCTIONS 

a.  Object  Program  Tape  Mounting  Instructions 

(1)  Mount  object  program  DECtapes  as  follows: 

.  DECtape  #572  as  DT  0  (PDP-9  Operating  System) 

.  DECtape  #568  as  DT  2  (RPSS  Application  System) 

b.  Loud  System  Maintenance  Routine,  DSKSAV 

(1)  Place  program,  DSKSAV,  in  console  paper  tape  reader 

(2)  Set  console  ADDRESS  switches  to  77720  (octal). 

(3)  Depress  the  following  console  function  keys  in  the  order  indicated 
below: 

.  STOP  -  Stop  machine 

.  I/O  RESET  -  Clear  pending  I/O  and  interrupt  system 

status  indicators,  flags,  and  registers 

.  READIN  -  Initiate  hard-wired  "bootstrap"  paper 

tape  loading  sequence. 

c.  Select  DECtape-to-Disk  Program  Loading  Options 

Place  the  following  PDP-9  DISK  CONTROL  UNIT  panel  switches  in  the  "OFF" 
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(down)  or  "ON"  (up)  positions  at  the  completion  of  the  DSKSAV  loading  operation.  The 
operator  will  be  signalled  at  the  completion  of  this  operation  by  the  following  system 
generated  administrative  message. 

"DSKSAV" 

Disk  control  panel  settings: 

.  Control  switches  0-29  -  "OFF" 

WRITE  PROTECT  switch  -  "OFF" 

d.  Transfer  PDP-9  Operating  System  Object  Programs  from  DECtape-to- 

Memory-to-Disk  File  Storage 

(1)  System  maintenance  program,  DSKSAV,  loads  object  coded  executive 
system  programs  from  DECtape  to  active  core  memory.  The  resulting  core  image 
program  is  then  transferred  onto  disk.  To  initiate  the  execution  of  this  function,  per¬ 
form  the  following  sequence  of  console  operations: 

.  Set  console  ACCUMULATOR  switches  to  000000s 

.  Depress  CONTINUE 

(2)  Upon  the  successful  completion  of  system  program  transfer  from  DEC¬ 
tape  0  to  disk  storage,  the  following  administrative  message  is  typed  on-line  via  the 
console  keyboard/page  printer: 

"DSKSAV" 

e.  Re«et  Disk  Control  Panel  Opdons  to  Initiate  the  Loading  and  Building  of  an 

RPSS  Disk  Resident  Program  File 

(1)  Place  the  following  PDP-9  Disk  Control  Unit  panel  switches  in  the  "OFF" 
(down)  or  "ON"  (up)  positions: 

.  Control  switches  0-29  -  "ON" 

WRITE  PROTECT  switch  -  "ON" 

f.  Transfer  RPSS  Object  Programs  from  DECtape-to-Memory-to-Disk  File 

Storage 

(1)  Initiate  transfer  of  RPSS  object  program  from  DECtape  2  to  disk  file 
storage  as  follows: 
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Set  console  ACCUMULATOR  switches  to  0000028 


.  Depress  CONTINUE 

(2)  The  following  message  will  be  typed  on-line  when  the  program  load  and 
transfer  operation  previously  described  has  been  completed: 

’’DSKSAV" 

3.  D1SK-TO-CORE  PDP-9  MONITOR  LOADING  INSTRUCTIONS 

a.  Load  the  Disk  File  Resident  MONITOR  System  Into  Active  Core  Memory 

(1)  Place  system  utility  program,  DISK,  in  console  paper  tape  reader 

(2)  Set  console  ADDRESS  switches  to  77637g 

(3)  Depress  the  following  console  function  keys  in  the  order  specified  below: 
,  STOP 

.  I/O  RESET 
.  READIN 

(4)  Upon  the  successful  completion  of  the  above  program  loading  function, 
the  following  system  generated  administrative  message  is  typed  on-line: 

"MONITOR  V4E" 

(5)  The  above  message  signals  the  termination  of  the  operating  and 
applications  program  system  disk  loading  sequence,  and  indicates  that  the  core 
resident  MONITOR  program  is  available  for  use. 
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SECTION  n 


RASTER  PLOTTER  SOFTWARE  SYSTEM  (RPSS)  OPERATING  INSTRUCTIONS 

1.  GENERAL 

The  paragraphs  which  follow  provide  the  stepwise  instructions  and  procedures 
for  1)  loading  and  2)  initializing  the  RPSS  applications  program.  As  previously 
described  in  SECTION  I,  the  RPSS  object  program  is  initially  transferred  from  DEC- 
tape  to  disk  file  memory  storage  media  prior  to  its  execution  by  the  PDP-9  hardware 
and  executive  software  system.  Both  the  program  loading  from  disk  and  initializa¬ 
tion  at  time  of  execution  are  performed  via  the  on-line  console  teletype  (ASR33).  The 
user  interacts  with  the  memory  resident  PDP-9  MONITOR  system  to  initiate  and 
implement  program  link  loading  functions,  to  enter  required  constants,  settable 
control  parameters,  and  data.  The  on-line  procedures  required  to  enact  these  two 
functions  are  described  separately  to  avoid  confusion. 

In  the  following  paragraph  the  following  notational  convention  is  employed  to 
differentiate  between  typed  message  outputs  generated  by  either  the  MONITOR  or 
RPSS  system,  and  response  messages  entered  by  the  user  during  the  enactment  of 
program  loading  and  intialization  procedures.  As  shown  in  the  example  below  all 
program  generated  output  messages  are  underscored,  while  user  inputs  are  not. 

Example: 

System  Output  Message:  MONITOR  V4E 

Operator  Input  Message:  LOAD 

2.  RPSS  PROGRAM  LOADING  INSTRUCTIONS 

a.  MONITOR  V4E 

System  generated  message  to  signal  the  operator  that  the  system  MONITOR  is 
core  memory  resident  and  available  for  use  (see  Paragraph  3.  0  SECTION  I) . 

b.  $ 

System  generated  mnemonic  indicating  that  the  MONITOR  is  ready  to  receive 
operator  inputs. 

c.  A  MTF7  7 

Enter  above  message  to  assign  magnetic  tape  drive  to  logical  unit  7. 


Preceding  page  blank 
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d. 


LOAD 


Entry  of  above  message  will  cause  the  MONITOR  to  read  the  disk  operating 
system  link  loader  routine,  LOAD,  into  active  core  memory. 

e.  LOADER  V4A 

System  response  message  typed  on-line  after  the  retrieval  and  loading  of 
program,  LOAD,  has  been  completed.  This  is  fo!  owed  by  the  system  generated 
mnemonic; 

which  signals  that,  LOAD,  is  memory  resident  am  available  to  accept  user  inputs. 

f.  A,  B,  C . T,  U 

Mnemonics  A,  B  . . . . ,  U  are  symbolic  m  mes  assigned  to  the  main  and  sub¬ 
programs  constituting  the  RPSS  object  program  loac  modules.  The  above  input 
message  must  be  terminated  by  depressing  the  ALT  MODE  Key. 

g. ;  RPSS  74451 


.CB  60053 


Core  memory  map  output  in  response  to  input  message  2,g  above.  Map 
contains  names  and  start  locations  of  RPSS,  PDP-9  Object-Time  and  Science 
Library  programs  and  routines  loaded  into  active  memory  by  the  link  loader  program, 
LOAD. 

h.  *S 


Operating  system  generated  mnemonic  typed  on-line  to  signal  the  completion 
of  the  disk-to-core  memory  program  link  loading  procedure. 

At  this  point  the  "virtual"  cor;  image  of  the  RPSS  and  required  system's 
library  and  object -time  programs  reside  in  memory. 
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MONITOR  V4E 


$A  MTF7  7 
SLOAD 

LOADER  V4A  „ 

>A»3»C»D»E*F»G»H* 

RPSS  74466 
SCODE  73473 
MKENT  72414 
GNR  71606 
SCAN  71515 
SHLSRT  71271 
SRCH  71136 
INTWDL  71012 
OUTWDL  70701 
PBYTE  70555 
IMESG  70227 
NPAGE  70001 
PRNSTT  67331 


NSET 

67225 

SETA 

67115 

BLK 

67067 

SETM 

67014 

SETC 

66751 

BITS 

66542 

MGFRW 

66346 

BSPEOF 

66161 

MTF. 

65001 

LPA. 

64316 

DTA. 

53416 

DKA. 

47056 

TIME 

64243 

.DA 

64174 

BCD  10 

61145 

AUXIO 

61047 

.SS 

60767 

GOTO 

60741 

STOP 

60726 

PAUSE 

60712 

SPMSG 

60617 

FIOPS 

60057 

OTSER 

46762 

INTEGE 

;  46643 

REAL 

45607 

.CB 

60037 

1S1Q6 

FIGURE  III-l.  RPSS  PROGRAM  LOAD  MAP 
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j.  fQ6 

Entry  of  the  above  response  input  message  causes  the  MONITOR  to  transfer 
the  current  core  image  to  AREA  6  of  disk  file  memory. 

k.  MONITOR  V4E 

Operating  System  generated  administrative  message  output  to  signal  the 
completion  of  the  previously  described  core-to-disk  memory  function  (see  2.  j.). 

l.  $ 

Operating  System  generated  mnemonic  output  on-line  to  signal  the  "ready" 
status  of  the  MONITOR;  i.e. ,  to  receive  user  inputs. 

m.  G  6 

Entry  of  the  above  input  message  cause  the  load  module  residing  in  disk 
AREA  6  to  be  read  into  active  memory. 

n.  fs 

Entry  of  the  "Control  S"  message  causes  control  to  be  transferred  from  the 
MONITOR  to  the  entry  point  of  the  main  program,  RPSS,  Execution  of  the  application 
program  will  begin  at  this  point  ,.ith  the  initialization  function.  This  is  described  in 
further  detail  in  Paragraph  3.  0. 

3.  PROGRAM  INITIALIZATION  AND  CONTROL  INSTRUCTIONS 

This  section  provides  a  detailed  description  of  the  procedural  steps  needed  to 
initialize  the  Raster  Plotter  Software  System.  The  program  initialization  process  is 
implemented  by  means  of  a  query-response  control  mechanism.  The  on-line  teletype 
serves  as  the  primary  communications  link  between  man  and  machine,  and  is  employed 
to  generate  administrative  messages  instructing  the  user  of  the  specific  data  and 
control  parameters  needed  for  normal  execution;  to  generate  diagnostic  messages 
signaling  the  type  of  keying  or  procedural  errors  committed  by  the  user  during  the 
initialization  process;  and  to  serve  as  the  input  medium  for  user  response  messages. 

All  user  input  messages  must  be  terminated  by  a  carriage  return,  unless  otherwise 
indicated. 

The  RPSS  is  designed  to  execute  in  one  of  two  selectable  operational  modes; 
Automatic  or  "Tape  Mode"  and  Semi-automatic  or  "Manual  Mode". 

a.  Tape  Mode  (Automatic)  --  This  mode  of  operation  processes  all  the  raster 
formatted  records  appearing  on  the  input  data  file  in  a  serial  manner,  translating 
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each  from  its  raw  to  its  final  raster  record  format.  Provisions  are  not  included  to 
permit  manual  selection  of  data  conversion  based  upon  either  channel  or  density 
parameters,  or  both.  Instructions  for  initializing  this  mode  of  operation  are  pro¬ 
vided  in  Paragraph  4. 

b.  Manual  Mode  (semi-automatic)  —  This  is  the  alternate  mode  of  operation 
and  provides  the  user  with  provisions  for  feature  class  selection  criteria  based  upon 
various  channel  and  density  combinations.  There  are  thirty -two  (32)  density /channel 
combinations  possible,  and  these  may  be  specified  and  assigned  to  known  feature  types 
at  time  of  execution  by  means  of  the  on-line  Keyboard  entry  device.  The  stepwise 
procedures  for  enacting  this  option  are  described  in  Paragraph  6. 

4.  TAPE  MODE  INITIALIZATION  INSTRUCTIONS 

a.  MOUNT  NEW  SCRATCH  ON  DRIVE  n  ENTER  D  WHEN  DONE 


Mount  a  full  magnetic  scratch  tape,  and  set  to  the  logical  unit  specified. 
When  this  task  is  completed  respond  with  the  following  input  message: 

D  (CR) 

Note:  (CR)  -  carriage  return 

b.  ENTER  MONTH,  DAY,  YEAR  AS  6  NUMERICS  ...  MMDDYY 
Enter  date  in  the  format  specified  by  the  above  output  message. 
EXAMPLE:  For  February  18,  1971,  enter: 

021871  (CR) 

c.  ENTER  5  DIGIT  TAPE  ID  NUMBER 


Five  digit  tape  identification  number  used  to  uniquely  uefine  the  current 
output  data  file. 

EXAMPLE 

01239  (CR) 

d.  MOUNT  FIRST  REEL  OF  INPUT  TAPE  ON  DRIVE  m 


Mount  input  data  file  and  set  to  logical  unit  specified.  NOTE,  no 
response  required  after  the  completion  of  this  operator  task.  However,  failure  to 
execute  this  step  in  the  initialization  sequence  will  result  in  a  "conditional  halt'  when 
this  unit  is  initially  selected  during  the  exectuion  phase  of  RPSS. 
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e.  ENTER  fc  DIGIT  MINIMUM  AREA  IN  PROPER  RESOLUTION 


Entry  equivalent  to  MIN  AREA  setting  at  which  the  source  input  graphic  was 
processed  by  the  AOSD.  For  example,  if  the  machine  setting  was  M.  A.  =  3,  this 
would  be  entered  as: 

000003  (CR) 

f.  DO  YOUR  WISH  TO  SUPPLY  SELECTION  CODES  EXTERNALLY 

ENTER  Y  OR  N_ 

System  generated  m-ssage  stating  the  optior  modes  of  operation.  A  message 
response  of: 

N  (CR)  -  Indicates  "TAPE  MODE"  selection 

Y  (CR)  -  Indicates  "MANUAL  MODE"  selection 

g.  Enter  N  (CR) 

h.  ARE  THERE  MORE  INPUT  TAPES  FOR  THIS  RUN  IN  ADDITION  TO  THAT 

CURRENTLY  MOUNTED  ON  DRIVE  m  ENTER  Y  OR  N 

Y  (CR)  denotes  multi-reel  input  file 

N  (CR)  denotes  single-reel  input  file 

i.  MOUNT  NEY^  INPUT  ON  DRIVE  i 

This  output  message  is  only  printed  if  the  response  to  the  previous  query 
message  (4  h)  is  affirmative  (i.e. ,  Y).  No  operator  response  is  required  at  the 
completion  of  this  task. 

j .  ENTER  D  IF  PROPER  INPUT  TAPE  MOUNTED  ON  DRIVE  m 

The  above  message  is  generated  irrespective  of  the  response  to  message 
4.  h.  its  purpose  is  to  proved  an  additional  check  point  for  input  tape  assignment 
validation. 

Respond  with  the  following  input  message  for  acknowledgement  of  input  file 
assignment: 

D  (CR) 
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k.  Entry  of  the  above  input  message  initiates  the  input  data  file(s)  format 
conversion  process.  No  further  messages  will  appear  until  either  the  input  data  file 
is  exhausted  or  the  output  is  filled.  In  the  latter  case  the  following  system  generated 
message  will  appear. 

l.  AT  PAUSE  2,  MOUNT  NEW  SCRATCH  ON  DRIVE  n  AND  CONTINUE 
PAUSE  000002 


When  the  above  messages  appear,  remove  the  tape  from  the  unit  specified  by 
numeric,  n,  and  replace  it  with  a  full  reel  of  magnetic  tape. 

To  continue,  enter  the  following  input  message: 

jip  (CNTRL  P)  -  Causes  processing  to  continued  from  the  point  of 
interruption  utilizing  a  new  output  tape  file. 

m.  FIRST  Y  COORDINATE  IS  yyyyy 

Message  to  the  operator  indicating  the  Y  address  of  the  first  scan  line 
encountered  so  that  the  graphic  plotter  carriage  address  may  be  set  at  this  value. 

This  number  is  in  decimal.  No  operator  response  is  required  at  the  completion  of 
this  message. 

n.  BAD  WRITE  AT  IWRITE  =  wwwww 

Message  to  the  operator  indicating  the  probability  of  erroneous  data  being 
written  on  the  output  tape.  The  scan  line  where  this  occurs  is  in  the  vicinty  of  the 
first  Y  coordinate  plus  the  value  of  IWRITE.  This  number  is  in  decimal.  No 
operator  response  is  required  at  the  completion  of  this  message. 

o.  BAD  READ  AT  EREAD  =  rrrrr 


Message  to  the  operator  indicating  the  probablity  of  erroneous  data  being 
read  from  the  input  data  tape.  The  scan  line  where  this  occurs  is  in  the  vicinity  of 
the.  first  Y  coordinate  plus  the  value  of  IREAD.  This  number  is  in  decimal.  No 
operator  response  is  ,'equired  at  the  completion  of  this  message. 

p.  TOTAL  READS  =  rrrrr 

TOTAL  WRITES  =  wwwww  +  1 

Message  to  the  operator  indicating  the  number  of  blocks  of  data  read  from 
the  input  tape  and  written  onto  the  output  tape.  These  numbers  are  in  decimal.  No 
operator  response  is  required  at  the  completion  of  this  message. 
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MONITOR  V4E 


SG  6 

tS 

MOUNT  NEW  SCRATCH  ON  DRIVE  5  ENTER  D  WHEN  DONE 
D 

ENTER  MONTH, DAY, YEAR  AS  6  NUMERICS  ...  MKDDYY 
072071 

ENTER  5  DIGIT  TAPE  ID  NUMBER 

inn 

MOUNT  1ST  REEL  OF  INPUT  TAPE  ON  DRIVE  6 

ENTER  6  DIGIT  MINIMUM  AREA  IN  PROPER  RESOLUTION. 

0000C3 

DO  YOU  WISH  TO  SUPPLY  SELECTION  CODES  EXTERNALLY 
ENTER  Y  OR  N 
N 

ARE  THERE  MORE  INPUT  TAPES  FOR  THIS  RUN  IN  ADDITION  TO  THAT 
CURRENTLY  MOUNTED  ON  DRIVE  6  ENTER  Y  OR  N 

N 

ENTER  D  IF  PROPER  INPUT  TAPE  IS  MOUNTED  ON  DRIVE  6 
D 

FIRST  Y  COORDINATE  IS  212 
TOTAL  READS  =  330 

TOTAL  WRITES  =  328  +  1 

DO  YOU  WISH  TO  TERMINATE  RUN  <Y  OR  N) 

Y 

REMOVE  OUTPUT  TAPE  ON  DRIVE  5 

LAPEL  IT  DATE  7/20/71  TAPE  NUMBER  11111  REEL  NUMBER  0 
HMD  OF  RUN  -  REMOVE  ALL  TAPES  FROM  DRIVES 


*+*  TERMINAL  IT N  *** 


STOP  W00r00 


FIGURE  III-2.  RPSo  PROGRAM  RUN:. TAPE  MODE 


-132- 


5.  TAPE  MODE  POST- PROCESSING  PRINTOUTS  AND  RUN  TERMINATION 

PROCEDURES 

Upon  completing  an  input  data  file  processing  cycle,  a  tabulatioi  of  run  and  I/O 
statistical  data  will  be  output  on  the  PDP-9  line  printer.  These  include  elapsed  run 
time,  the  number  of  input  records  processed,  and  the  number  output  for  each  channel. 
At  the  conclusion  of  this  file  the  following  query -response  dialogue  is  initiated. 

a.  DO  YOU  WISH  TO  TERMINATE  RUN  (Y  OR  N) 

Y  (CR)  -  Denotes  unconditional  termination  of  program.  Control  is  returned 
to  MONITOR  system. 

N  (CR)  -  Denotes  a  request  for  an  additional  processing  cycle. 

b.  DO  YOU  WISH  TO  STACK  OUTPUT  FILES  (Y  OR  N) 

The  above  message  is  output  at  the  console  ASR33,  if,  and  only  if,  the 
response  to  message  5  a  is  a  N.  The  responses  to  this  message  are  as  follows: 

Y  (CR)  -  Indicates  the  continued  use  of  the  current  output  tape  file  for  the 

next  processing  cycle. 

N  (CR)  -  Denotes  that  a  new  output  tape  file  is  desired. 

c.  REMOVE  OUTPUT  TAPE  ON  DRIVE  N 

LABEL  IT  DATE  mm/dd/yy.  TAPE  NUMBER  nnnnn,  REEL  NUMBER  rr 

This  message  appears  if  the  operator  response  to  the  previous  query 
(5  b)  is  negative,  i.  e. ,  a  or  if  response  to  5  b  is  affirmitive  i.e,, ,  a  Y. 

Operator  response  to  this  message  is  not  required. 

d.  END  OF  RUN  -  REMOVE  ALL  TAPES  FROM  DRIVE" 


***  TERMINATION  *** 

his  is  the  final  message  output  by  the  system  prior  to  termination  and 
transfer  of  control  to  the  resident  MONITOR  system. 

6.  MANUAL  MODE  INITILIZATION  INSTRUCTIONS 

a.  MOUNT  NEW  SCRATCH  ON  DRIVE  n  ENTER  D  WREN  DONE 

Mount  a  full  magnetic  scratch  tape,  and  set  to  the  logical  unit  specified. 
When  this  task  is  completed  respond  \,.'th  the  following  input  message:. 
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D(CR) 


Note:  (CR  =  carriage  return 

b.  ENTER  MONTH,  DAY,  YEAR  AS  6  NUMERICS  ...  MMDDYY 
Enter  date  in  the  format  specified  by  the  above  output  message. 
EXAMPLE:  For  February  18,  1971,  enter: 

021871  (CR) 

c.  ENTER  5  DIGIT  TAPE  ID  NUMBER 

Five  digit  tape  identification  number  used  to  uniquely  define  the  current 
output  data  file. 

EXAMPLE 

01239  (CR) 

d.  MOUNT  FIRST  REEL  OF  INPUT  TAPE  ON  DRIVE  m 


Mount  input  data  file  and  set  to  logical  unit  specified.  NOTE,  no  response 
required  after  the  completion  of  this  operator  .task.  However,  failure  to  execute  this 
step  in  the  initialization  sequence  will  result  in  a  "conditional  halt"  when  this  unit  is 
initially  selected  during  the  execution  phase  of  RPSS. 

e.  ENTER  6  DIGIT  MINIMUM  AREA  IN  PROPER  RESOLUTION 

Entry  equivalent  to  MIN  AREA  setting  at  which  the  source  input  graphic 
was  processed  by  the  .vCSD.  For  example,  if  the  machine  setting  was  M.  A.  =  3,  this 
would  be  entered  as: 

00u003  (CR) 

f.  DO  YOU  WISH  TO  SUPPLY  SELECTION  CODES  EXTERNALLY 

ENTER  Y  OR  Nf 

System  generated  message  stating  the  option  modes  of  operation.  A 
message  response  of: 

N  (CR)  -  Indicates  "TAPE  MODE"  selection 

Y  (CR)  -  Indicates  "MANUAL  MODE'  selection 

Enter 

Y  (CR) 
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g.  ENTER  DEFAULT  DENSITY  AS  NUMBERIC  FROM  0  TO  7 

Enter  a  default  density  so  that  each  output  will  have  a  density  on  the  raster 
plotter.  For  example  to  have  density  of  3,  enter 
3  (CR). 

h.  ENTER  C"\NNEL  NUMBER  FROM  1  TO  4  OR  ENTER  0  TO  END 

SELECTlO  4  CODE  INPUT  EACH  TIME  CH  NR  =  IS  TYPED 

The  first  of  the  series  of  channel/data  query-response  message  sequence 
permitting  the  input  of  data  selection  keys  and  corresponding  output  channel  assignment 
codes.  This  is  a  perparatory  message  informing  the  operator  how  to  respond.  No 
operator  response  is  requiied  at  this  time. 


i.  CH  NR  = 


At  this  time  enter  the  channel  number  for  which  the  feature  associated  with 
the  ^election  codes  are  to  be  output.  Entries  are  as  follows: 

1  (CR)  channel  1  designated  or  output 


4  (CR)  channel  4  designated  as  output 

0  (CR'  Indicates  the  end  of  the  channel/data  query  response  cycle 

j.  ENTER  CODES  (WYZNNNNNMMMMM) 

Enter  list  of  feature  extraction  keys  ox’  codes  in  the  format  indicated 

WYZNNNNNMMMMM 

The  WYZNM  fields  have  the  following  meanings: 

W  -  Process  control  field  where: 

A  =  All  else  data  extraction  Key 
E  =  Data  extraction  exception  indicator 
N  =  Normal  extraction  code  entry  designator 
X  =  End  of  extraction  code  list  indicator 

Y  ~  Range  definition  code,  where: 

S  =  Denotes  a  ringleor  1:1  input  code  to  output  channel  definition 
mapping. 
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R  =  Denotes  that  a  set  of  input  codes  between  the  range  specified 
by  the  NNNNN  and  MMMMM  field  inclusive,  are  to  be  mapped 
to  tne  given  output  channel. 

Z  -  Output  density  designator  field 

Integer  value  ranging  from  0-7 

NNNNN  -  Input  data  extraction  Key  (or  code) 

Five  digit  decimal  number,  right  adjusted  with  leading  zeroes  as 
needed. 

MMMMM  -  Terminal  range  extraction  Key 

Five-digit  decimal  number,  right  adjusted  with  leading  zerors  as 
needed 

If  field  Y  is  an  "S",  then  enter 
00001 

(1)  For  a  normal  single  selection  code  of  density  7  with  the  selection  code  of  39 
the  following  entry  would  be  made 

NS70003900001  (CR) 

(2)  If  all  remaining  input  data  is  desired  to  be  output  at  one  specific  line  weight 
and  density,  the  All  Else  data  extraction  key  of  the  process  control  field  would  be 
entered.  This  deviates  the  need  to  enter  all  the  selection  codes.  To  initiate  this 
function  the  following  entry  would  be  made 

AS700002000ul  (CR) 

This  response  states  that  for  the  channel  indicated  in  response  to  6i  all 
input  data  unless  otherwise  specified  will  be  output  with  a  density  of  7. 

(3)  If,  in  conjunction  with  the  All  Else  function,  a  specific  feature  is  not  to  be  out¬ 
put  at  all,  the  data  extraction  exception  indicator  of  the  process  control  field  would 
be  used.  An  example  of  this  function  is  illustrated  by  the  following  entry. 

ES60000500001  (CR) 

This  response  says  that  the  feature  whose  selection  code  is  5jq  is  not  to  be 
output. 
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(4)  To  terminate  the  selection  code  enteries  for  a  particular  channel,  the  following 
entry  would  be  made: 

X  i _ i  (CR)  where  , _ ,  =  space 

k.  OK 


Response  from  the  system  to  the  operator  when  the  selection  code  entered 
has  been  accepted.  Another  selection  code  can  then  be  entered  after  the  OK  response 
has  been  encountered. 

l.  ERRONEOUS  SELECTION  CODE  ENTRY  -  WILL  NOT  BE  PUT  IN  TABLE 

ENTRY  AS  RECEIVED  IS 

W  Y  Z  NNNNN  MMMMM 

AT  PAUSE  1  CONTINUE  OR  MANUALLY  TERMINATE 

PAUSE  000001 

A  message  to  the  operator  indicating  that  an  error  existed  in  the  last  entered 
selection  code.  The  operator  wishes  to  input  selection  codes  then  he  enters. 

fp  'CNTRL  P) 

At  this  time  the  operator  will  then  be  able  to  re-enter  the  selection  code.  If 
the  operator  wishes  to  terminate  execution  he  should  enter 

fc  (CNTRL  C) 

and  control  will  return  to  the  MONITOR  system. 

m.  SELECTION  CODE  TABLE  FULL  -  LAST  ENTRY 

W  Y  Z  NNNNN  MMMMM 

A  message  to  the  operator  indicating  the  finish  of  the  channel/data  query 
response  cycle  due  to  an  excess  of  selection  codes.  Processing  will  continue  as  if  the 
channel/data  query  response  cycle  terminated  normally.  No  operator  response  is 
required  at  this  time. 

n.  SELECTION  CODE  SUMMARY  ON  PRINTER.  ARE  CORRECTIONS 

REQUIRED  ENTER  Y  OR  N 

This  message  appears  at  the  end  of  the  channel/data  query  response  cycle. 
That  is,  when  the  response  to  message  6i  is  zero  (0).  The  summary  on  the  on-line 
printer  is  in  numeric  order  according  to  selection  codes  and  shows  the  density  and 
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channel  on  which  the  feature  will  be  output.  (Channels  here  are  indicated  ad  0,  1,  2, 
3).  If  there  are  errors,  a  response  of 

Y  (CR) 

will  restart  the  channel/density  query  response  cycle.  If  the  table  is  correct,  enter 
N  (CR). 

o.  ARE  THERE  MORE  INPUT  TAPES  FOR  THIS  RUN  IN  ADDITION  TO  THAT 
CURRENTLY  MOUNTED  ON  DRIVE  m  ENTER  Y  OR  N 

Y  (CR)  denotes  multi-reel  input  file 
N  (CR)  denotes  single  reel  input  file 

p.  MOUNT  NEXT  INPUT  OR  DRIVE  i 

This  output  message  is  printed  if,  and  only  if,  the  response  to  the  previous 
query  message  (6.0)  is  affirmative  (i.  e. ,  Y).  No  operator  response  is  required  at 
the  completion  of  this  task. 

q.  ENTER  D  IF  PROPER  INPUT  TAPE  MOUNTED  ON  DRIVE  m 


The  above  message  is  generated  irrespective  of  the  response  to  message 
6.  0.  Its  purpose  is  to  provide  an  additional  check  point  for  input  tape  assignment 
validation. 

Respond  with  the  following  input  message  for  acknowledgement  of  input 
file  assignment: 

D  (CR) 

r.  Entry  of  the  above  input  message  initiates  the  input  data  file(s)  format 
conversion  process.  No  further  messages  will  appear  until  either  the  input  data 
file  is  exhausted  or  the  output  is  filled.  In  the  latter  case  the  following  system 
generated  message  will  appear. 

s.  AT  PAUSE  2,  MOUNT  NEW  SCRATCH  ON  DRIVE  r  AND  CONTINUE 

PAUSE  000002  . ~ 


When  the  above  messages  appear,  remove  the  tape  from  the  unit  specified 
by  numeric,  i.,  and  replace  it  with  a  full  reel  of  magnetic  tape.  To  continue,  enter 
the  following  input  message: 

|  P  (CNTRL  P)  -  causes  processing  to  continue  from  the  point  of 
iterruption  utilizing  a  new  output  tape  file. 
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t.  FIRST  Y  COORDINATE  IS  yyyyy 


Message  to  the  operator  indicating  the  Y  address  of  the  first  scan  line 
enco”ntered  so  that  the  graphic  plotter  carriage  address  may  bs  set  at  this  value. 

This  number  is  in  decimal.  No  operator  response  is  required  at  the  completion  of 
th„s  message. 

u.  BAD  WRITE  ATA  I  WRITE  -  wwwww 

Message  to  the  operator  indicating  the  probability  of  erroneous,  data 
being  written  on  the  output  tape  .  The  scan  line  where  this  occurs  is  in  the  vicinity  of 
the  first  Y  coordinate  plus  the  value  of  IWRITE.  This  number  is  in  decimal.  No 
operator  response  is  required  at  the  completion  of  this  message. 

v.  BAD  READ  AT  IREAD  =  rrrrr 

Message  to  the  operator  indicating  the  probability  of  erroneous  data  being 
read  from  the  input  data  tape.  The  scan  line  where  this  occurs  in  in  the  vicinity  of 
the  first  Y  coordinate  plus  the  value  of  IREAD.  This  number  is  in  decimal.  No 
operator  response  is  reqi  ired  at  the  completion  of  this  message. 

w .  TOT  A  L  READS  =  rrrrr 

TOTAL  WRITES  =  wwwww  +  1 

Message  to  the  operator  indicating  the  number  of  blocks  of  data  read  from 
the  input  tape  and  written  onto  the  output  tape.  These  numbers  are  in  decimal.  No 
operator  response  is  required  at  the  completion  of  this  message. 

7.  POST- PROCESSING  PRINTOUTS  AND  RUN  TERMINATION  PROCEDURES 

Upon  completing  an  intput  data  file  processing  cycle,  a  tabulation  of  run  and 
I/O  statistical  data  will  be  output  on  the  PD  P-9  line  printer.  These  include  elapsed 
run  time,  the  number  of  input  records  processed,  and  the  number  output  for  each 
channel.  At  the  conclusion  of  this  file  the  following  query-response  dialogue  is 
initiated. 

a.  DO  YOU  WISH  TO  TERMINATE  RUN  (  Y  OR  N) 

Y  (CR)  -  Denotes  unconditional  termination  of  program.  Control  is 
returned  to  MONITOR  system. 

N  (CR)  -  Denotes  a  request  for  an  additional  processing  cycJe. 

b.  DO  YOU  WISH  TO  STACK  OUTPUT  FILES  (Y  OR  N) 

The  above  message  ;s  output  at  the  console  ASR35  if,  and  only  if,  the 
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MONITOR  VAE 


SG  6 
*S 

MOUNT  NEW  SCRATCH  ON  DRIVE  5  ENTER  D  WHEN  DONE 
D 

ENTER  MONTH* DAY* YEAR  AS  6  NUMERICS  ...  MMDDYY 
0^2071 

ENTER  5  DIGIT  TAPE  ID  NUMBER 
99999 

MOUNT  1ST  REEL  OF  INPUT  TAPE  ON  DRIVE  6 

ENTER  6  DIGIT  MINIMUM  AREA  IN  PROPER  RESOLUTION. 

000003 

DO  YOU  WISH  TO  SUPPLY  SELECTION  CODES  EXTERNALLY 
ENTER  Y  OR  N 

y 

ENTER  DEFAULT  DENSITY  AS  NUMERIC  FROM  0  TO  7 


ENTER  CHANNEL  NUMBER  FROM  1  TO  A  OR  ENTER  0  TO  END 
SELECTION  CODE  INPUT  EACH  TIME  CH  NR  =  IS  TYPED 
CH  NR  - 


A 

ENTER  CODES  ( WYZNNNNNMMMMM ) 
NS 500 0A 700001 
OK 


X 

CH  NR  = 

0 

SELECTION  CODE  SUMMARY  ON  PRINTER.  ARE  CORRECTIONS  REQUIRED 
ENTER  Y  OR  N. 

N 


FIGURE  II 1-3.  RPSS  PROGRAM  RUN:MANUAL  MODE 
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ARE  THERE  MORE  INPUT  TAPES  FOR  THIS  RUN  IN  ADDITION  TO  THkT 
CURRENTLY  MOUNTED  ON  DRIVE  6  ENTER  Y  Oh  N 

N 

ENTER  D  IF  PROPER  INPUT  TAPE  IS  MOUNTED  ON  DRIVE  6 
D 

FIRST  Y  COORDINATE  IS  212 
TOTAL  READS  =  330 

TOTAL  WRITES  =  32C  +  1 

DO  YOU  WISH  TO  TERMINATE  RUN  (Y  OR  N> 

Y 

REMOVE  OUTPUT  TAPE  ON  DRIVE  5 

LABEL  IT  DATE  7/20/71  TAPE  NUMBER  099999  REEL  NUMBER  0 
END  OF  RUM  -  REMOVE  ALL  TAPES  FROM  DRIVES 


♦  TERMINATION  *** 


STOP  000000 


FIGURE  II I -3.  RPSS  PROGRAM  RUN:MANUAL  MODE  (CONCLUDED) 
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respond  to  message  7a  is  a  N.  The  response  to  tfc.^  message  are  as  follows: 

Y  (CR)  -  Indicates  the  continued  use  of  the  current  output  tape  file  'or  the 
next  processing  cycle. 

N  (CR)  -  Denotes  that  a  new  output  tape  file  is  desired. 

c.  REMOVE  OUTPUT  TAPE  ON  DRIVE  n 

LABEL  IT  DATE  mm/dd/yy,  TAPE  NUMBER  nutmn,  REEL  NUMBER  rr 

This  message  appears  if  tho  operator  response  to  the  previous  query  (7b) 
is  negative,  i.  e. ,  an  or  if  response  to  7a  is  affirmative  i.  e. ,  a  Y.  Operator  response 
to  this  message  is  not  required. 

d.  DO  YOU  WISH  SAME  SELECTION  CODES  AS  PREVIOUS  RUN  (Y  OR  N) 

If  additional  processing  cycle  is  requested  (i.  e. ,  response  to  7a  is  N), 
thic  message  appears  to  determine  if  the  selection  codes  for  the  new  input  tape  are 
the  same  as  the  previous.  If  they  are,  then  the  channel/data  query  response  cycle 
is  avoided,  in  this  case  the  response  sho  lid  be 

Y  (CR). 

If  there  are  any  changes  in  the  selection  code0 ,  the  channel/data  query 
response  cycle  must  be  restarted  and  in  this  case,  the  r  esponse  should  be 

N  (CR). 

This  latter  response  can  also  be  used  to  change  mode  of  operation  to 
Tape  Mode,  if  so  desired. 

e.  END  OF  RUN  -  REMOVE  ALL  TAPES  FROM  DRIVES 

♦♦♦TERMINATION*** 

This  is  the  final  message  output  by  the  system  prior  to  termination  and 
transfer  of  control  to  the  resident  MON™OR  system. 

8.  PROCESSING  STATISTICAL  DATA  OUTPUTS 

Immediately  following  the  successful  completion  of  the  generation  of  a  drive  tape 
for  the  graphic  plotter,  timing  and  data  statistics  are  presented  on-line  via  the  line 
printer.  These  include  the  number  of  scan  lines  input  and  output,  number  of  data 
points  processed,  the  number  of  points  of  various  ACSD  designator  codes  and  the 
number  of  points  output  per  channel. 
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SECTION  I 


RASTER  PLOTTER  SOFTWARE  SYSTEM  PROGRAM 

1.  GENERAL 

The  RPSS  Program  described  in  this  appendix  consists  of  fifteen  FORTRAN 
language  subprograms  and  four  MACRO  assembler  language  routines  which  are  funct¬ 
ionally  unique . 

Section  II  provides  a  detailed  description  of  the  nineteen  unique  subprograms  of 
the  RPSS  Program .  Subsection  1  contains  the  program  descriptions  of  both  the 
FORTRAN  and  MACRO  subprograms.  Subsection  2  identifies  the  existing  PDP-9 
Object-Time  System  programs  and  Science  Library  MACRO  subroutines  called  by  the 
RPSS  Program  for  various  FORTRAN  IV  input/output  functions.  Section  III  contains 
the  flow  diagrams  for  the  required  RPSS  assembly  language  subprograms.  Section  IV 
contains  the  autoflow  diagrams  for  the  required  RPSS  FORTRAN  subprograms. 

2.  SYSTEM  DESCRIPTION 

The  RPSS  Piogram  is  a  self-contained,  stand  alone  program  designed  to  be  ex¬ 
ecuted  on  a  PDP-9  processing  system  having  the  following  configuration: 

Quantity  Equipment  Item  Description 

1  DEC  PDP-9  Control  Processing  Unit  (CPU) 

8  4096  18-bit  Word  Core  Memory  Modules 

1  10  CPS,  Console  Keyboard/Teleprinter 

3  7 -Track,  45IPS,  556/800  B PI  IBM  Compatible  Magnetic 
Tape  Units  W/Controller 

4  DECtape  Uni’s  W/Controller 

1  DEC  PDP-9  Paper  Tape  Reader 

1  DEC  PDP-9  Paper  Tape  Punch 

1  1  Million  18-Bit  Word  Disk  File  W/Controller 

i  ANELEX,  1000  LPM  Line  Printer 

a.  Object  Program  Deck  Arrangement 

The  RPSS  Program  is  assembled  and  compiled  as  a  "relocatable"  program. 
With  the  exception  of  the  control  program  (RPSS),  which  by  definition  must  be  the 
first  program  in  the  object  deck,  the  remaining  object  programs  may  be  arranger1  m 
any  order. 
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b.  System  Diagrams 

Figure  IV-1  shows  the  control  logic  flow  for  the  RPSS  program.  PD  P-9 
OTS  and  Science  Library  subprograms  apd  routines  are  not  shown  since  they  are  load¬ 
ed  and  enter  the  procedureal  flow  only  at  the  time  of  execution. 

Figure  IV-2  shows  the  overall  system  block  diagram  of  the  RPSS  pro¬ 
gram,  while  Figure  IV-3  and  IV-4  show  the  Tape  and  Manual  mode  block  diagrams 
respectively. 


c.  Logic  Diagram  Symbology 

The  syllabus  of  logic  diagram  symbo’jgy,  as  shown  in  Figure  IV-5, 
defines  the  program  flow  chart  notation  conventiors  employed  in  this  appendix. 
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RETURN  TO  PDI*-9  SYSTEM  MONITOR 


FIGURE  IV- 1.  SYSTEM  LOGIC  FLOW  DIAGRAM 
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FIGURE  IV  -  2.  RASTER  PLOTTER  SOFTWARE  SYSTEM  BLOCK  DIAGRAM 


215 


-147- 


FIGURE  IV  -  2.  RASTER  PLOTTER  SOFTWARE  SYSTEM  BLOCK  DIAGRAM  (CONTINUED) 
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FIGURE  rv  -  2.  RASTER  PLOTTER  SOFTWARE  SYSTEM  BLOCK  DIAGRAM  (CONCLUDED) 
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FIGURE  IV  -  3.  RPSS  TAPE  MODE  BLOCK  DIAGRAM 
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FIGURE  IV  -  4.  RPSS  MANUAL  MODE  BLOCK  DIAGRAM 
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SUBPROGRAM  NAME  BOX 
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INTERNAL  SUBPROGRAM  CALL  BOX 

X--FLOW  DIAGRAM  PAGE  NUMBER  (X  OF  N) 
Y-LINE  ON  PAGE 
Z-BOX  IN  LINE 

EXTERNAL  SUBPROGRAM  CALL  BOX 


POP-9  SYSTEM  CALL  BOX 
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INPUT'OUTPUT  box 


LOGICAL  P 

X-FLOV  RAM  PAGE 
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FIGURE  IV -5 .  LOGIC  DIAGRAM  SYMBOLOGY 
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SECTION  n 


DESCRIPTION  OF  SUBPROGRAMS 

1.  WORKER  AND  UTILITY  PROGRAMS 

a.  RPSS  (Raster  Plotter  Software  System  Control  Program) 

(1)  Abstract 

RPSS  is  the  main  control  program  of  the  Raster  Plotter  Software 
System.  It  oversees  all  the  supervisory  functions  required  to  handle  the  output  format 
and  determines  whether  the  tape  format  or  the  selection  code  assignment  format  is  to 
be  utilized.  The  rogram  then  reads  raster  scan  lines  from  the  input  tape  by  calling 
GNR,  locates  and  extacts  the  proper  selection  code  using  the  selection  code  table 
(SRCH)  and  reformats  and  places  it  into  the  output  k.»  ier  area.  The  program  then 
calls  MGFRW  to  write  the  record  on  the  output  tape.  Upon  completion,  statistical 
information  is  output  by  PRNSTT  via  the  on-line  printer  and  control  is  returned  to 
the  PDP-9  monitor  system . 

(2)  Program  Description 

RPSS,  during  system  initialization,  jecei.es  via  the  on-line  tele¬ 
type  all  the  pertinent  information  necessary  to  process  the  selected  raster  format  in¬ 
put  tape.  Formatting  and  selection  for  output  can  proceed  in  one  of  two  paths.  The 
first  path  is  that  of  data  transfer  and  reorganization  for  the  final  output  tape.  In  this 
mode,  referred  to  as  Tape  Mode,  it  is  necessary  for  the  user  to  supply  a  minimum  area 
for  future  recognition  of  this  parameter  in  the  data  set.  The  input  information  is  then 
read  from  the  input  tape  by  a  call  to  GNR.  If  no  EOF  or  EOT  is  encountered,  the  data 
point  is  typed,  i.  e. ,  whether  it  is  an  X  -  or  Y  -  coordinate  and  is  then  placed,  after 
formatting,  in  an  output  buffer,  located  in  core,  for  future  transfer  to  tape.  The 
coordinate  is  stored  with  the  associated  line  center  designator  End/or  area  start/stop, 
channel  number,  and  density  in  proper  plotter  format.  For  the  minimum  area  case 
an  additional  area  stop  coordinate  is  generated.  The  buffer  is  written  to  the  output 
tape  when  one  of  two  conditions  occur.  The  first  when  the  buffer  is  filled  and  the  sec¬ 
ond  is  when  a  new  Y  -  coordinate,  is  encountered  before  the  buffer  is  filled.  Tape 
reading  and  writing  is  handled  by  calls  to  MGFRW.  The  second  mode  of  operation, 
referred  to  as  the  Manual  Mode,  allo\, s  the  user  to  select  which  features  on  die  input 
tape  he  would  like  to  have  on  the  output  tape.  Each  feature  has  a  unique  selection  code 
for  ease  m  recognition.  SCODF  nandles  all  the  necessary  procedures  to  obtain  the 
required  nformation  for  selection  code,  channel  number  and  density.  The  procedure 
for  data  handling  is  the  same  then  as  for  the  tape  mode  with  the  addition  that  each 
coordinate  has  its  "selection  code"  compared  to  the  selection  code  table  (by  SRCH)  to 
ensure  that  A  is  an  extracted  feature.  If  it  is  not  a  desired  feature,  it  is  not  placed 
in  the  output  buffer;  if  it  is  a  desired  feature  then  all  pertinent  information  for 
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proper  plotter  operation  is  placed  in  the  buffer.  Processing  then  continues  as  pre¬ 
viously  discussed.  Statistical  information  is  compiled  throughout  execution  and  is 
output  via  the  on-line  printer  at  the  end  of  each  inn  upon  completion  of  successful 
execution. 


(3)  Inputs 

(a)  Calling  Sequence  - 

None  -  stand  alone  program . 

(b)  Keyboard  Entries  -  Operator  Input  Responses  - 

D 

mmddyy  (month,  day,  year) 

iiiiii  (tape  ID) 

Y 

N 

aaaaaa  (minimum  area) 

CNTL  P  (for  continuation) 

(c)  Magnetic  Tape  - 

Raster  formatted  data  tape  containing  all  necessary  inform¬ 
ation  in  proper  format. 

(4)  Outputs 

(a)  Teleprinter  - 

Program  generated  query  and  administrative  messages 
"MOUNT  NEW  SCRATCH  ON  DRIVE  ENTER  D  WHEN  DONE" 
"ENTER  MONTH,  DAY,  YEAR  AS  6  NUMERICS  .  .  .MMDDYY" 
"ENTER  5  DIGIT,  TAPE  ID  NUMBER" 

"MOUNT  1ST  REEL  OF  INPUT  ON  DRIVE  " 
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"DO  YOU  WISH  TO  SUPPLY  SELECTION  CODES  EXTERN¬ 
ALLY  ENTER  Y  OR  N" 

"ENTER  6  DIGIT  MINIMUM  AREA  IN  PROPER  RESOLUTION" 

"AT  PAUSE  2,  MOUNT  NEW  SCRATCH  ON  DRIVE _ 

AND  CONTINf  E"  '  ” 

"DO  YOU  WISH  TO  TERMINATE  RUN?  (Y  OR  N)" 

"REMOVE  OUTPUT  TAPE  ON  DUVE_ _ LABEL  IT: 

DATE; _ / _ / _ ,  TAPE  NUMBER; _ 

REEL  NUMBER  " 


"DO  YOU  WISH  TO  USE  SAME  SELECTION  CODES  AS 
PREVIOUS  RUN  (Y  OR  N)" 

"END  OF  RUN  -  REMOVE  ALL  TAPES  FROM  DRIVES" 


***  TERMINATION  *** 


"BAD  WRITE  AT  IWRITE  - _ 

"TOTAL  WRITE  i  =  +  I" 


(b)  Magnetic  Tape  - 

Raster  formatted  tape  for  use  on  the  Graphic  Plotter. 

(5)  Referenced  Subprograms 

SCODE 

GNR 

SRCH 

PBYTE 

IMESG 

PRNSTT 

NSET 

SETA 

SETM 

SETC 

MGFRW 
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Bit  Routines: 


LS 

LO 

LEOR 

LA 

RS 


b.  SCODE  (Selection  Code) 

(1)  Abstract 

SCODE  is  that  part  of  the  Raster  Plotter  Software  System  that 
handles  the  selection  code  processing  before  reading  the  input  data  tape.  This  sub¬ 
routine  accepts  the  selection  codes,  densities,  and  channel  numbers  that  will  be  used 
as  the  selection  criteria  for  the  final  output  product.  SCODE  performs  ad  the  prelim¬ 
inary  handling  of  the  selection  code  information.  In  addition,  SCODE  sets  the  -ALL 
ELSE  channel  if  and  when  it  is  selected. 

(2)  Program  Description 

SCODE  reads  in  from  the  TTY  Keyboard  the  necessary  information 
to  form  the  Selection  Code  Table  (ISC).  The  first  thing  read  in  is  the  default  density. 
The  table  is  then  preset  with  the  default  density  being  placed  in  each  entry  of  the  tables. 
Right  after  this  is  done  the  ALL  ELSE  functions  are  cleared  and  tie  ALL  ELSE  channel 
is  sei  to  channel  5.  The  selection  code  is  read  in  on  a  per  channel  basis.  Then  the 
desired  channel  number  is  read.  The  procedure  of  obtaining  the  selection  codes  is 
continued  until  either  the  user  signifies  end  of  selection  code  assignment  or  until  the 
selection  code  table  has  been  completely  filled.  Entries  to  the  table  are  made  by 
MKENT.  After  the  last  entry  has  been  made  the  Selection  Code  Table  is  sorted 
(SHLSRT)  and  the  entire  table  in  sorted  order  is  printed  the  on-line  printer  so  that 
the  user  will  have  a  hard  copy  of  the  selection  code,  cnannel,  density,  and  delete  status. 
The  ALL  ELSE  information  is  also  output  at  this  time.  The  user  is  then  queried  to 
determine  whether  or  not  the  list  is  acceptable .  If  not  accepr  ole  the  selection  code 
assignment  procedure  is  repeated,  ajcepted,  control  returns  to  the  main  program 
to  continue  processing. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  SCODE 


Arguments: 


None 


(b)  Teletype  Keyboard  - 

d 
n 
A 
R 
S 
N 
E 
X 
Y 
N 

(4)  Outputs 

(a)  Teleprinter  - 

Program  generated  query  and  administrative  messages. 

"ENTER  DEFAULT  DENSITY  AS  NUMERIC  FROM  0  TO  7" 

"ENTER  CHANNEL  NUMBER  FROM  1  TO  4  OR  ENTER  0 
TO  END  SELECTION  CODE  INPUT  EACH  TIME  CH  NR  = 

IS  TYPED" 

"CH  NR  =  " 

"ENTER  CODES  ( W Y ZNNNNNMMMMM) " 

"SELECTION  CODE  SUMMARY  ON  PRINTER.  ARE  COR¬ 
RECTIONS  REQUIRED  ENTER  Y  OR  N." 

(b)  On-Line  Printer  - 

Information  printed  in  addition  to  that  printed  by  subroutine 
NPAGE  are  the  selection  code  information  to  appear  in  tabular  form.  The  last  entry 
at  the  end  of  the  list  would  be 

"ALL  ELSE" 

under  the  selection  code  heading,  with  the  proper  channel  number  and  density  appear¬ 
ing  under  the  appropriate  column  headings.  The  ALL  ELSE  information  will  be  printed 
only  if  ALL  ELSE  has  been  specified. 


(default  density) 
(channel  number) 


Referenced  Subprograms 


(5) 


INTWDL 

MKENT 

SHKSRT 

NPAGE 


c.  MKENT  (Make  Table  Entry) 

(1)  Abstract 

MKENT  reads  the  input  selection  code  and  enters  it  into  the 
selection  code  table  (ISC)  for  the  selection  code  mode  of  operation.  The  status  of  the 
selection  code  table  is  checked  before  and  after  each  entry.  If  there  is  an  entry  for 
a  particular  selection  code  already  in  the  table,  the  previous  entry  will  be  overwritten. 
A  return  parameter  indicates  the  status  of  the  table  after  the  entry  has  been  made. 

(2)  Program  Description 

Before  entering  the  selection  code  for  a  specific  previously  de¬ 
signated  channel  into  the  table,  a  series  of  error  checks  are  made.  These  checks 
include 


a.  a  test  for  end  of  input 

b.  erroneous  entry 

c.  is  it  the  ALL  ELSE  channel 

After  these  checks,  MKENT  determines  if  the  delete  flag  is  either 
on  or  off,  if  the  default  density  is  to  be  implemented  or  if  a  density  has  been  irput,  and 
whether  the  selection  code  being-  input  is  a  single  value  or  a  range  of  values.  <.t  this 
time  placement  into  the  table  can  proceed.  Before  the  actual  entry  is  made  the  select¬ 
ion  code  table  is  checked  for  a  duplicate  entry  (same  selection  code)  by  a  call  to  SCAN. 
If  SCAN  indicates  a  duplicate,  the  previous  entry  is  overwritten.  If  there  *s  no  dupli¬ 
cate  entry,  the  pointer  is  advanced  to  the  next  available  spot.  INTWDL  is  then  c.  Ued 
to  place  the  selection  code  in  the  first  word  and  to  pack  the  density  channel  number 
previously  designated  and  delete  flag  (if  on)  into  the  second  word  of  the  table  entry. 
After  each  entry,  the  table  is  checked  to  see  if  it  is  full.  The  table  is  large  enough 
to  hold  1000  selection  codes  with  associated  channel  number,  density  ard  delete  flag. 

If  the  table  is  full,  further  inputs  are  ignored  and  processing  continues  without  the 
additional  inputs.  If  a  range  of  selection  codes  was  input,  entries  are  made  for  each 
selection  in  the  entire  range  until  the  range  is  exhausted.  The  return  parameter  in¬ 
dicates  the  status  of  the  table. 
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(3)  Inputs 


(4) 


(a)  Calling  Sequence  -  CALL  MKENT  (IF LG) 

Arguments:  IFLG  -  return  parameter  from  MKENT  telling 
the  status  of  the  selection  code  table 

-  3  table  is  fuli  after  entry  made 

-  2  erroneous  entry,  not  processed 

-  1  end  cf  input  encountered 

0  All  Else  Channel  assigned 
positive  number 

the  location  (pointer) 
number  assigned  the  entry  in  select¬ 
ion  code  table . 

(b)  Entries  -  Selection  Code  Information  - 
WY  ZNNNNNNMMMMM 

ALL  ELSE  channel  assignment 
Except  =  Delete  Flag  Set 
Normal  Entry 
End  of  Input 
cingle  selection  code 
Range  of  selection  codes 
Density 

Start  of  selection  code  or  signal 
selection  code 

End  of  selection  code  (if  Y  =  R, 
otherwise  00001) 


"SELECTION  CODE  TABLE  FULL  -  -  LAST  ENTRi 


W 


Y  = 

Z  = 

NNNNN  = 

MMMMM  = 


A 

E 

N 

X 

s 

R 


Outputs 

(a)  Teleprinter 
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"ERRONEOUS  SELECTION  CODE  ENTRY  -  WILL  NOT  BE 

PUT  IN  TABLE 

ENTRY  AS  RECEIVED  IS: 

WY  ZNNNNNMMMMM 

AT  PAUSE  1,  CONTINUE  OR  MANUALLY  TERMINATE. 

(5)  Referenced  Subprograms 

SCAN 

INTWDL 

d.  GNR  (Get  Next  Record) 

(1)  Abstract 

GNR  gets  the  next  record  from  the  input  tape  containing  th. ;  data 

to  be  processed. 

(2)  Program  Description 

GNR  issues  the  calls  to  MGFRW  to  read  the  input  tape  and  store 
it  in  a  local  buffer.  GNR  then  investigates  the  Mock  of  data.  If  an  EOT  or  EOT  is 
encountered  ,  control  is  returned  to  the  main  program  noting  the  condition.  If  no  E  OF 
or  EOT  is  encountered,  GNR  then  determines  if  the  block  is  the  first  block  for  a  give  a 
raster  line,  or  a  continuation  clock .  GNR  also  determines  whether  the  data  is  an  X  - 
coordinate  or  a  Y  -  coordinate .  Subsequent  calls  return  the  next  coordinate  from  the 
buffer  until  it  is  empty. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  GNR 

Arguments:  NONE 

(4)  Outputs 

(a)  Memory  - 

Buffer  area  filled  with  the  record  read  from  the  input  tape. 

(b)  Teletype  - 
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"FIRST  Y  COORDINATE  IS 
"BAD  READ  AT  IREAD  =  _ 

"TOTAL  READS  = _ 

(5)  Referenced  Subprograms 
MGFRW 


e.  SCAN  (Scan  Selection  Code  Table) 

(1)  Abstract 

SCAN  checks  the  Selection  Code  Table  (ISC)  before  entries  are 
made  to  insure  that  no  duplicate  entries  exist.  If  a  duplicate  is  found,  its  position  is 
returned  to  the  calling  program . 

(2)  Program  Description 

SCAN  is  a  loop  that  checks  each  member  of  the  selection  code 
table  (ISC)  against  the  new  selection  code  to  be  entered  (IVAL).  This  is  performed  on 
the  uasorted  table  as  the  table  is  being  built,  to  avoid  duplicate  entries.  It  is  perform- 
;d  each  and  every  time  an  entry  is  to  be  made  in  the  selection  code  table .  If  a  dupli¬ 
cate  is  found,  a  pointer  to  that  duplicate  entry  is  returned  to  the  calling  program  in  the 
parameter  K.  If  no  duplicate  is  found,  that  is.  if  the  selection  code  has  not  been  pre¬ 
viously  entered  in  the  table,  a  return  code  of  -1  is  passed  in  the  parameter  K. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  SCAN  (IVAL,  K) 

Arguments: 

IVAL  =  Selection  Code  for  which  the  table  is  to  scanned 
to  determine  if  it  is  a  duplicate  entry 

K  *  Return  argument  telling  status  of  IVAL  in  the 
selection  code  table  where: 

-1  IVAL  did  not  previously  appear  in  the 
table 

t  -1 


IVAL  did  previously  appear  in  the  table 
and  K  contains  its  location  with  the  table 
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(4)  Outputs 
None 

(5)  Referenced  Subprograms 
None 


f.  SHLSRT  (Shell  Sort) 

(1)  Abstract 

SHLSRT  performs  a  Shell  sort  on  the  entries  of  the  Selection  Code 
Table  (ISC).  The  table  is  ordered  in  ascending  selection  code  with  each  two  word 
entry  of  the  table  being  mover’  as  necessary. 

(2)  Program  Description 

SHLSRT  is  an  algebraic  comparison  of  the  entries  in  the  selection 
code  table  (ISC)  made  on  the  first  word  of  the  table  entry.  This  routine  is  called  after 
the  last  entry  has  been  made.  T*ie  table  is  ordered  by  ascending  selection  code  with 
the  second  word  of  the  entry  being  switched  when  necessary,  to  remain  with  its  proper 
selection  code . 

(3)  Inputs 

(a)  Calling  sequence  -  CALL  SHLSRT 

Arguments:  None 

(4)  Outputs 

None 

(5)  Referenced  Subprograms 

None 

g.  SRCH  (Search  The  Table) 

(1)  Abstract 

SRCH  performs  a  binary  search  of  the  sorted  Selection  Code 
Table  to  determine  if  a  particular  selection  code  is  in  the  table.  The  return  argument 


tells  the  status  of  the  selection  code . 


(2)  Program  Description 

SRCH  is  called  after  the  input  data  tape  is  read  to  determine  if 
a  particular  selection  code  is  in  the  Selection  Code  Table  (TSC).  A  binary  search  is 
incorporated  to  optimize  the  seaich  time  as  the  table  lookup  has  to  be  done  for  each 
coordinate  from  the  input  tape.  If  the  selection  code  is  found  a  return  argument  in¬ 
dicating  the  location  in  the  table  is  returned.  If  the  selection  code  is  not  found,  i.  e. , 
not  in  the  table,  a  value  of  -1  is  returned. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  SRCH  (IARG,  K) 

Arguments: 

IARG  The  selection  code  the  table  is  being  search¬ 

ed  for. 

K  =  Return  argument.  If  it  is -1,  the  selection 
code  was  not  found.  If  a  positive  integer 
then  it  is  a  pointed  to  the  position  in  tne 
Selection  Code  Table  to  where  the  select¬ 
ion  code  is . 


(4)  Outputs 
None 

(5)  Referenced  Subprograms 
None 

h.  INTWDL  (Input  -  Table  Word  Logic) 

(1)  Abstract 

INTWDL  makes  the  entry  in  the  Selection  Code  Table  (ISC).  The 
first  word  of  the  entry  is  the  selection  code  and  the  second  word  contains  the  density, 
channel  number  and  delete  flag,  packed  in  proper  format  for  output  on  the  graphic 
plotter. 
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(2) 


Program  Description 


r 


INTWDL  utilizes  the  bit  manipulation  routines  in  order  to  pack 
the  second  word  of  the  Selection  Code  Table  (ISC)  entry.  The  parameters  to  be  txit 
into  the  table  are  paired  in  the  labelled  common  B1  and  the  location  is  passed  in  the 
argument  K.  The  selection  code  is  immediately  placed  into  the  first  word  as  a  integer. 
The  form  of  the  second  word  is  as  follows: 


bits  0-5 
0  -  8 

9 

10  -  11 

12  -  16 

17 


are  zero 

contain  the  density 
contains  a  '< 

contains  the  channel  nun.ber 

are  zero 

is  the  delete  flag 


The  second  byte  (bits  6  -  11  )  of  the  second  word  contains  the  density 
and  channel  number  m  the  proper  format  for  output  on  the  graphic  plotter.  Before  the 
entry  is  made,  the  location  in  the  selection  code  table  ;s  cleaved  to  to  avoid  any 
extraneous  information  for  the  bit  routines. 

(3)  Inputs 

(a)  Calling  Sequence-  CALL  INTWDL  <K) 

Arguments:. 

K  -  Selection  Code  Table  location  for  which  the  entry  is 
to  be  made . 

(4)  Outputs 

(a)  Memory  - 

Selection  code  table  entry  containing  selection  code,  den¬ 
sity,  channel  aumber  and  delete  flag. 

(5)  Referenced  Subprograms 

Bit  Routines:.  LS 

1.0 

LLOR 
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i.  OUTWDL  (Output  -  Table  Word  Logic) 

(1)  Abstract 

OUTWDL  reads  the  entry  from  the  selection  code  table  and  de¬ 
codes  the  second  word  of  the  entry  into  the  density,  channel  numter  and  delete  flag. 

(2)  Program  Description 

fbo  first  word  of  the  Selection  Code  Table  (ISC)  entry  contains 
only  the  selection  code.  The  second  word  in  packed  form  contains  the  density,  channel 
number  and  delete  flag  (see  INTWDL).  The  bit  manipulation  routines  are  used  to  unpack 
the  second  word  and  extract  the  desired  information.  The  unpacked  parameters  are 
then  passed  by  the  labeled  common  HI. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  OUTWDL  (K) 

Argument: 

K  =  Selection  Code  Table  location  for  which  the  entry  is 
to  be  extracted. 


(<1 Outputs 

(a)  Memory  - 

The  selection  code,  density,  channel  number  and  delete 
flag  stored  in  labeled  common  HI. 

(5)  Reference  Subprograms 

Bit  Routines: 

LA 

RS 

j.  PBYTE  ^Byte  Placement) 

(i)  Abstract 

PBYTE  is  a  byte  manipulation  routine  that  shifts  bytes  either  left 
or  righ;  in  a  PDP-9,  18-bit  (3-byte)  word. 
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(2)  Program  De  scription 

PBYTE  shifts  bytes  either  left  or  right  in  the  PDP-9,  18-bit,  word. 
The  byte  location,  IB,  of  the  input  word,  IW,  is  shift  to  byte  location,  IOB,  of  the  out¬ 
put  word,  IOW.  The  bit  manipulation  routines  are  used  to  perform  the  necessary  shifts. 
If  IB  is  greater  than  IOB,  a  shift  left  is  performed;  if  IB  is  less  than  IOB,  a  shift  right 
is  performed.  The  amount  shifted,  in  bytes,  is  determined  by  the  difference  between 
IB  and  IOB. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  PBYTE  (IW,  IB,  IOW,  IOB) 
Arguments: 

IW  -  Input  word  whose  byte  is  to  be  shifted 

IB  =  Byte  location  in  input  word  of  byte  to  be  shifted . 

1  is  most  significant  byte ,  2  is  middle  byte ,  and  3 
is  least  significant  byte . 

IOW-  Output  word  into  which  the  shifted  byte  from  IW  is 
to  be  placed. 

IOB=  Byte  location  output  word  of  where  shifted  byte  from 
IW  is  to  be  placed  in  IO\v .  J  is  most  significant  byte , 
2  is  middle  byte,  and  3  is  least  significant  byte. 

NOTE:  IW  and  IOW  may  be  the  same  word  in  the  calling  program. 

(4)  Outputs 

(a)  Memory  - 

A  PDP-9,  18  bit,  word  with  byte  shifted. 

(5)  Referenced  Subprograms 

Bit  Routines:  LA 

LO 

LS 

RS 
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k  MESG  (Messages) 

(1)  Abstract 

IMESG  is  the  routine  that  handles  the  input  tape  messages  to  de¬ 
termine  if  additional  processing  is  desired. 

(2)  Program  Description 

IMESG  queries  the  user  to  determine  if  there  are  any  further  in¬ 
put  tapes  required  for  the  present  run.  If  there  are,  it  issues  the  proper  tape  mount 
message  and  insures  that  the  proper  tape  is  mounted  for  processing.  IMESG  also 
switches  the  magnetic  tape  drives  unit  numbers  which  are  used  for  the  inDut  so  that 
continual  processing  may  take  place.  IMESG  also  sets  the  done  flag  if  no  further  inputs 
are  required. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  IMESG 

Arguments:;  None 

(b)  Keyboard  entries  - 

7 

N 

D 

(4)  Outputs 

(a)  Teletype  - 

"ARE  THERE  MORE  INPUT  TaPES  FOR  THIS  RUN  IN 
ADDITION  TO  THAT  CURRENTLY  MOUNTED  ON  DRIVE 
_ ENTER  Y  OR  N." 

"MOUNT  NEXT  INPUT  TAPE  ON  DRIVE 


"ENTER  D  IF  PROPER  INPUT  TAPE;  IS  MOUNTED  ON 
DRIVE _ " 

(b)  Memory  - 

Done  flag,  located  m  common  Jl,  is  either  set  or  not  set 
depending  on  response  to  the  first  query. 
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(5)  Referenced  Subprogram 


None 

l.  NPAGE  (New  Page) 

(1)  Abstract 

NPAGE  writes  the  heading  information  for  the  Selection  Code 
Table  —  Input  Summary  on  the  line  printer.  Information  printed  is  the  month,  day, 
year,  page  number,  output  tape  number  and  file  number,  revision  number.  Also 
printed  is  the  heading  for  the  table  for  the  selection  code,  channel  number,  density 
ano  delete  flag.  The  title  is  also  printed  at  the  top  of  the  page. 

(2)  Program  Description 

NPAGE  is  a  series  of  write  statements  to  the  on-line  printer. 

The  same  information  appears  on  the  top  of  each  page  that  is  needed  for  the  Selection 
Code  Table  -  input  Summary. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  NPAGE 
Arguments:  None 

(4)  Outputs 

(a)  On-line  printer  - 

Program  generates  heading  information  on  tne  on-  line  printer 
"RPS  SELECTION  CODE  TABLE  -  INPUT  SUMMARY  PAGE  — " 

"TAPE  NUMBER - " 

"FILE  NUMBER  — " 

"REVISION  —  " 

"SELECTION  CODE  CHANNEL  DENSITY  DELETE  FLAG" 

(5)  Referenced  Subprograms 
None 

m.  PRNSTT  (Print  Run  Statistics) 

(1)  Abstract. 
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PRNSTT  prints  the  statistics  for  a  given  run  after  execution  of  that 
run  has  been  completed. 

(2)  Program  Description 

PRNSTT  prints  the  statistics  for  a  given  run  on  the  on-line  printed 
that  have  been  accumulated  for  the  run.  These  include:  data;  tape  number;  file  number; 
elapsed  time  for  the  run  in  minutes  and  seconds;  the  number  of  scan  lines  input;  total 
number  of  coordinates;  number  of  designator  points  processed;  channel  totals  processed 
for  each  channel. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  PRNSTT 
Arguments:  None 

(4)  Outputs 

(a)  On-line  Printer  - 


"RPS  RUN  STATISTICS  OF  mm/dd/yy" 

"TAPE  NUMBER - " 

"FILE  NUMBER - " 

"RUN  STATISTICS" 

"ELAPSED  TIME  = - MINUTES  AND - SECONDS" 

" - SCAN  LINES  INPUT  CONTAINING - X  COOR¬ 

DINATES" 

"X  DESIGNATOR  OF  POINTS  PROCESSED  WERE" 


CODE 


COUNT 


"CHANNEL  TOTALS:  CHANNEL#  = - .CHANNEL 

1  = - . 

"CHANNEL  2  = - .  CHANNEL  3  =  —  - - ". 

(5)  Referenced  Subprograms 

None 

n.  NSET  (Set  Buffer) 

(1)  Abstract 

NSET  resets  the  pointers  to  thp  output  buffer.  It  also  clears  the 
buffer  and  presets  the  buffer  to  thp  high  ignore  value . 

(2)  Program  Description 

NSET  resets  the  next  entry  counter  to  the  beginning  of  the  output 
buffer  IOEjF.  The  LSTBYT  and  LSTWRD  parameters  are  initialized  to  the  original 
starting  state  ’  1  the  same  time  the  output  buffer  is  preset  to  the  high  order  ignore 
value.  This  is  contained  in  four  consecutive  PDP-9  words  which  gives  us  three  con¬ 
secutive  Graphic  Plotter  words  (24  bits  each).  These  words  have  o  high  order  ignore 
value,  less  than  the  EOL,  such  that  when  encountered,  the  plotter  will  go  over  the  max¬ 
imum  scan  position  and  thus  not  plot.  This  value  is  preset  as  a  line  centere  coordin¬ 
ate  to  insure  a  turning  off  of  any  areal  data, 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  NSET 
Arguments:  None 

(4)  Outputs 

(a)  Memory  - 

A  present  buffer  to  be  used  as  the  output  buffer  storage  for 
Graphic  Plotter  formatted  data. 

(5)  Reference  Subprograms 

None 
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o.  SETA  (Set  Area) 


(1)  Abstract 

SETA  is  used  to  set  the  area  stop  coordinate  when  a  minimum 
area  designator  is  obtained  from  the  input  data. 

(2)  Program  Description 

SETA  operates  on  the  coordinate  in  different  manners  depend¬ 
ing  upon  whether  the  coordinate  is  line  center,  area  start  or  minimum  area  data.  For 
line  center  data,  no  processing  is  done.  The  minimum  flag  is  set  to  zero  and  control 
is  returned  to  the  main  program.  For  area  start,  the  line  center  indicator  is  removed 
from  the  coordinate  control  word  to  signify  area  start.  The  minimum  flag  is  set  to  zero 
and  again  control  is  returned  to  the  main  program.  For  m^imum  area,  the  minimum 
area  designator  is  masked  out  of  the  coordinate  control  word  to  simulate  an  area 
start.  A  line  center  coordinate  is  added  to  end  minimum  area,  and  the  line  center 
indicator  is  removed  from  the  coordinate  control  word  of  the  first  word  to  signify  area 
start.  That  is,  minimum  area  has  been  converted  to  an  area  start  and  an  area  stop. 
Minimum  area  flag  is  set  equal  to  one . 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  SETA 
Arguments:  None 

(4)  Outputs 

(a)  Memoiy  - 

An  area  start  and  area  stop  coordinates  from  minimum 

area  settings  when  applicable . 

(5)  Referenced  Subprograms 

Bit  Routines:  LEOR 

LA 

p.  SETM  (Sat  Masks) 

(1)  Abstract 

SETM  is  an  assembler  language  routine  that  sets  the  masks  used 
by  the  RPS  system  to  obtain  the  desired  byte  of  a  given  data  word. 
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(2)  Program  Description 


SETM  sets  the  labelled  common  MASK  which  contains  MASK1 
and  MASK2,  Into  these  locations  it  sequentially  places  the  octal  constants  770000, 
007700  ,  000077  ,  007777  ,  770077  ,  777700.  These  then  are  used  as  masks  to  extract 
desired  information,  a  byte  at  a  time,  from  the  data  words  used  by  the  RPS  Bystem. 

(3)  Inputs 

(a)  Calling  Sequence  -  CALL  SETM  (MASK) 

Arguments: 

MASK  =  the  first  word  (starting  address)  if  the  6  word 
field  for  which  the  masks  will  be  formed. 

(4)  Outputs 

Memory  - 

Preset  masks. 

Kot  Referenced  Subprograms 

None 

q.  SETC  (Set  Constants) 

(1)  Abstract 

SETC  is  an  assembler  language  routine  that  sets  the  masks 
necessary  for  the  output  buffer  area  before  the  tape  write . 

(2)  Program  Description 

SETC  places  the  coordinate  corresponding  to  the  high  order 
"ignore"  value  for  the  raster  plotter.  This  value  is  one  less  than  the  EOL  character. 
The  masks  are  placed  in  the  array  INSET,  used  by  RPSS  to  preset  the  output  buffer 
area.  The  mash  is  four  words  long  of  the  form  043700,  000437,  000"!,  370000. 

The  masks  are  four,  18-bit  words  which  form  three  consec¬ 
utive  and  identical  24-bit  words  that  is  04370000.  This  is  the  desired  mask  for  the 
raster  plotter. 
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(3) 


Inputs 


(a)  Calling  Sequence  -  CALL  SETC  (INSET  (1)) 
Arguments: 

INSET  =  first  word  (starting  address)  of  the  4  word 
field  in  which  the  mask  will  be  formed. 


(4)  Outputs 
Memory  - 
Preset  mask. 

(5)  Referenced  Subprograms 
None 

r.  BITS  (Bit  Routines) 

(1)  Abstract 

BITS  is  an  assembler  language  subroutine  with  five  entries 
tl  at  allow  the  assembly  language  logic  and  shifting  functions  to  be  Fortran  Callable . 
The  logic  functions  incorporated  in  the  routine  are: 

Logical  AND  (LA) 

Logical  OR  (LO) 

Logical  Exclusive  OR  (LEOR) 

Left  Shift  (LS) 

Right  Shift  (RS) 

(2)  Program  Description 

These  functions  are  used  by  the  RPS  system  routines  that 
require  the  manipulation  of  bi's  on  an  integer  word.  For  the  logical  functions,  the 
routines  perform  the  necessary  operation  on  the  first  two  words  and  place  the  result 
in  the  third  word  of  the  calling  sequence.  For  the  shift  functions , the  first  word  is 
shifted  by  the  amount  indicated  in  the  second  word  and  stored  in  the  third.  Opera¬ 
tions  are  on  a  bit  basis . 
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inputs 

(q)  Calling  Sequence  - 

Logical  AND:  CALL  LA  (IA,  IB,  IC) 
Arguments: 

IA  =  Integer  word  to  be  AND'ed  with  3 

IB  =  Integer  word  to  be  AND'ed  with  IA 

IC  -  Integer  word  containing  result 
L  e . ,  IA  .AND.  IB^JC 
Logical  OR:  CALL  LO  (IA,  IB,  IC) 

Arguments: 

IA  =  Integer  word  to  be  ORed  with  IB 

IB  =  Integer  word  to  be  ORed  wit'  *a 
IC  =  Integer  word  containing  result 
i.  e,,  IA  .OR,  ib  »~ic 
Logical  Exclusive  OR  CALL  LEOR  (IA,  IB,  IC) 
Arguments; 

IA  =  Integer  word  to  be  EORed  with  IB 
IB  -  Integer  word  to  be  EORed  with  LA 
IC  -  integer  word  containing  result 

4 

i.  o.  IA  .ECR.  IB^ic 
Left  Shift:  CALL  LS  (IA,  IB,  1C) 

Arguments; 

LA  *  integer  word  tj  be  shacted  left. 


IB  =  Integer  word  containing  the  number  of  bits 
to  be  shifted . 

IC  =  Integer  word  containing  result 
i.  e .  Shift  IA  left  IB  bits  and  store  in  IC 
Right  Shift:  CALL  RS  (IA,  IB,  IC) 

Arguments: 

IA  =  Integer  word  to  be  shifted  right 

IB  =  Integer  word  containing  the  number  of  bits  to 
be  shifted 

IC  =  Integer  word  containing  result 
i.  e .  Shift  IA  right  IB  bits  and  store  in  IC 


(4)  Outputs 

Memory  word  that  is  result  of  logical  operation. 

(a)  Referenced  Subprogram 
None 

s.  MGFRW  (Magnetic  Tape  Read/Write) 

(1)  Abstract 

MGFRW  is  an  input/output  Fortran  callable,  assembly  lan¬ 
guage  utility  program  used  to  read  and  write  blocks  of  data  to  and  from  standard  mag¬ 
netic  tape. 


(2)  Program  Description 

Subprogram  MGFRW  is  utilized  by  the  RPS  system  to  trans¬ 
fer  data  between  core  memory  and  standard  magnetic  tape.  The  tape  handling  funct¬ 
ions  periormed  are:  Read  Tape,  Write  Tape,  Rewind  Tape,  and  Write  End-of-File 
(WEOF).  A  calling  program  specifies  which  of  these  functions  is  to  be  implemented 
by  a  numeric  code  in  the  calling  sequence.  Upon  entry  into  MGFRW,  this  code  and 
the  remaining  parameters  needed  to  inmate  the  indicated  tape  operation  are  extracted 
from  the  calling  sequence .  The  required  instruction  sequence  is  executed  and  the 
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program  enters  a  "wait"  loop  until  the  I/O  operation  is  completed.  At  completion  of 
a  read/write  operation,  MGFRW  retrieves  and  interrogates  the  bit  settings  of  the  I/O 
status  register.  A  unique  code  is  stored  in  a  predetermined  location  in  calling 
sequence  to  indicate  the  success  or  failure  of  the  requested  read/write  operation. 
Control  is  then  returned  to  the  calling  program.  The  calling  program  may  proceed 
normally,  or  initiate  an  exception  procedure,  or  terminate,  whichever  is  applicable. 

(3)  Inputs 

(a)  Calling  Sequence  -  Call  MGFRW  (ARG1 ,  ARG2,  ARG3, 
ARG4,  ARG5)  all  arguments  are  integer  words  and: 

ARG1  =  machine  tape  number 

ARG2  =  number  of  words  to  be  transferred  to  or 
from  memory. 

ARG3  =  symbolic  name  of  memory  buffer  into  oi 
from  which  the  specified  number  of  words 
are  to  be  transferred. 

ARG4  =  function  code  (right  adjusted);  where: 

0  =  Read  Tape  1  =  Write  Tape 

2  =  WEOF  3  =  Rewind 

ARG5  -  completion  status  code  word  which  is  in¬ 
itially  zero  and  is  set  by  MGFRW  as 
follows: 

1  =  EOT  (End-of-Tape)  2  =  EOF  (End-of- 

File) 

3  =  No  Error  4  -  Parity  Erro^ 

5  -  No  MTF  Flag  6  =  Word  Length 

Error 

7  =  Error  Flag 

NOTE:  If  ARG2  (number  of  words)  is  not  equal  to  the 
physical  size  of  the  tape  record  read,  the  word  length  error  (7)  code  will  be  stored  in 
ARC5  of  the  calling  sequence.  If  ARG2  is  less  than  the  record  size,  N  words  will  be 
read  into  the  buffer  designated  by  ARG3  and  the  '  ape  advanced  to  the  end-oi-record 
gap.  If  ARG2  specifies  a  word  count  greater  than  or  equal  to  the  record  size,  only 
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N  words  (record  length)  will  be  read  into  memory. 

(b)  Memory  - 

Data  blocks  of  size  specified  by  ARG2 . 

(4)  Outputs 

(a)  Status  Register  - 

Contents  of  status  register  stored  in  ARG5  of  calling 
sequence.  The  numeric  values  and  their  meaning  are: 

Status  Value  Meaning 

1  Physical  end-of-tape 

2  End-of-file  detected 

3  Normal  Termination 

4  Parity  error 

5  Improper  termination 

6  Wrong  word  length 

7  Error  flag 
All  status  values  are  fixed  point  binary  numbers. 

(b)  Memory  - 

Data  blocks  of  size  specified  by  ARG2 . 

(5)  Referenced  Subprograms 
None 
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2. 


OBJECT-TIME  SYSTEM  AND  SCIENCE  i  "BRARY  ROUTINES 


a.  Object-Tims  System  Routines 


The  following  is  ‘  iist  of  PDP-9  FORTRAN  IV  Object- Time  System 
macro-subroutines  that  are  loaded  at  execution  time.  The  compiled  FORTRAN  coded 
convenaon  programs  which  contain  I/O  statements  include  output  calls  in  the  form  of 
globab  to  various  system  I/O  handler  routines.  When  the  compiled  object  program  is 
loaded,  the  compiler  aefined  global  sysbols  are  utilized  to  search  the  FORTRAN  library 
for  the  reeded  I/O  handler  routines.  These  are  loaded  into  memory  and  the  proper 
program  control  linkage  established  by  the  Link  Loader.  Detailed  description  for 
these  programs  are  provided  in  the  following  DEC  PDP-9  manual:  "Advanced  Software 
System  Programmer’s  Reference  Manual";  orde  number  DEC-9A-KFZA-D. 


Program  Name 
AUXIO 


BCDIO 


FIOPS 


GOTO  (.GO) 

OTSER  (.ER) 

PAUSE  (.PA) 


Function 


To  process  the  auxiliary  I/O 
statements;  BACK  SPACE, 

REWIND,  in  FORTRAN  IV 
program  and  subprograms. 

To  process  formatted  READ/ 

WRITE  statements  in  FOR¬ 
TRAN  IV  piograms  and  sub¬ 
programs. 

FIOPS  provides  the  necessary 
call  to  IOPS  (Input-Output  Proc¬ 
essing  System)  required  by  all 
FORTH/  N  I/O  statements. 

To  compute  the  index  of  a  com-  P.  11-14 
puted  GO  TO . 

To  announce  an  error  on  the  P.  11-18 

teletype . 

To  process  the  PAUSE  state-  P.  11-16 

rr  rnt. 


Ref.  Manual 
P,  11-8 

P,  11-3 

P.  11-10 


SPMSG  (.SP) 


To  print  the  octal  coded  number  P.  11-17 
with  STOP  and  PAUSE . 


.SS 


To  calculate  the  array  element  P.  11-12 
address. 


Program  Name 


Function 


Ret.  Manual 


STOP  (.ST)  To  process  the  STOP  state-  P.  11-15 

ment  and  return  control  to 
the  monitor. 

TIME  To  provide  the  ability  to  re-  P.  11-21 

cord  elapsed  time  in  minutes 
and  seconds. 

b.  Science  Library  Routines 

The  following  PDP-9  Science  Library  routines  are  utilized  by  the 
RPSS  programs.  These  programs  are  described  in  the  DEC  PDP-9  manual  referenced 
in  Section  n,  Subsection  2a  above: 

Routine  Name  External  Cells  Ref.  Manual 


.  CB  (Short  Get  Arg¬ 
ument) 

None 

p.ni-9 

.DA  (General  Get  Arg¬ 
ument) 

None 

P.III-8 

INTEGE  (Integer  Arith¬ 
metic) 

REAL 

P.III-8 

REAL  (Reai  Arithmetic) 

None 

P.III-8 
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SECTION  III 

ASSEMBLY  LANGUAGE  SUBPROGRAM  FLOW  DIAGRAMS 


Preceding  page  blank 


-181- 


**#►*/» 


SECTION  TV 

FORTRAN  SUBPROGRAM  AUTOFLOW  DIAGRAMS 
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Preceding  page  blank 


187 


IM 

\S 

<3 

X 


n  »r  c 

r*g  fv,  <Ni  rv 


L 


CflMMlIN  /Ml/  INSET*L^TWRf>»L5ITBVTtNENT*l  (IrltlF 


LC 


T«'X  *  1000 


hit  r ooui •  la  11 1  >  ova* 


J.I  4MS  UNV  dUVSS-iK  JiVC. 


?100  FORMAT  (  I  1 


147  C  SC  HOOE  -  3*T  THE  SELECTION  COOE 


IN  TABLE  -  CHECK  OFLETF  FL5C 


CALL  L  A1  i.PKt.MASM  3 


07/P2/TI  INPUT  LISTING  AUTOFLO*  CHART  SFT  -  ^  r*  ■*!  *1 


2*8  C  BUFFFR  FULL 


*inoj  -  seiOGi  !<,<■ 


317  CONTINUE 


AUTOFLOW  CHART  SFT  -  RPSS 


107  C  OUTPUT  TAPE  ERROR 


111*  (0002‘Alil)  Q*3«  Ol£ 


!7/?2/71  INPUT  LISTING  AUTOFLOW  f.HAR  T  SFT  - 


161  C  STACK  OUTPUT 


i«T  C  nUTVUf  T*PF  F INJSHFO  -  CANNOT  CTACK  -  NFFO  NPW  PIJTPUT  T  AP  F 


07/77/71  INPUT  LIST  INI*  AUTOFLON  CHAKT  SF  T  -  pot.5. 


AND  CHANNEL  N'/NBESS  THAT  KILL  BF  THE  SELECTION  CPITFPIA  FOB  THF 


FINAL  OUTPUT  PPPOUCT  HNCF  PROCESSING  IN  PHA$f  II  IS  COMPLETE^ 


s 
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44?  f  PRESET  SC  TAHLE 


475 


•••  OBTAIN  PARAMETERS  FROM  SC  TABLf 
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